Adds multiple rows with index

[trfi]

Adds multiple rows to the worksheet at the specified index and populates it with values

[burnash]

Thank you very much for your contribution. My bad I've missed this PR and added append_rows() from #556 and #694.
However, I think your contribution could be used as insert_rows() method that gspread is currently missing. For that, we would need to change the method name in the PR and the API call.

Let me know if you're interested in changing the PR.

[garethsb]

It would be very nice if the "insertDimension" and the values were put atomically. I think it would be possible by using "updateCells" ?

[burnash]

@garethsb-sony very good point. Thank you for the suggestion.

For the record, here's the link to updateCells docs: UpdateCellsRequest

@tr-fi let me know if you need help with reworking the PR.

[garethsb]

Thanks, @burnash ! (I assume insert_row should be reworked to call the new insert_rows as well, like append_row in master calls append_rows?)

[burnash]

@garethsb-sony yes, exactly. I'm also trying to figure out if the scalar versions of these methods are still needed. Maybe it would be a good idea to deprecate the scalar versions and reduce the API surface a bit.

[trfi]

@burnash You right insert_rows is more reasonable. So I changed the method name to insert_rows.

[burnash]

It looks like there's a problem with insert indices.

Steps to reproduce:

1. I have a sheet with consecutive values:

2. I call

wks.insert_rows([['r1.1','r1.2'],['r2.1', 'r2.2']], index=3)

Where wks is my worksheet.

3. I get

Where the expected result is 1, 2, r1.1, r2.1, 3, 4, etc in the column A.
It looks like the method overwrites the cell with value "3".

[trfi]

Sorry I did not test thoroughly. I fixed it but need you test again

[burnash]

No problem, thank you for fast response