如何在google sheet api中使用范圍？

Question

我想從 B3 添加一個新值。

B1:E1 是從 B 的第一行到 E 的第一行。

B:E 是從 B 的開頭到 E 的結尾。

我想知道當范圍是 B:E、B1:E1 時有什么區別。

當 A 列中有值時，新值會附加到 A 的末尾。

https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append

service = discovery.build('sheets', 'v4', credentials=credentials)
spreadsheet_id = 'my-spreadsheet-id
range_ = 'sheet1!B:E' vs'sheet1!B1:E1'  # Questions
value_input_option = ''
insert_data_option = ''

value_range_body = {

}

request = service.spreadsheets().values().append(spreadsheetId=spreadsheet_id, range=range_, valueInputOption=value_input_option, insertDataOption=insert_data_option, body=value_range_body)
response = request.execute()

pprint(response)

Answer 1

API 將通過檢查相鄰單元格的內容來檢查提供的范圍是否是數據表的一部分。 如果范圍及其相鄰單元格都包含數據，則該范圍被視為數據表的一部分。 （在您的示例中，數據表是A1:E10 ）

由於B:E和B1:E1在單元格B1 中有數據並且B1與單元格A1的數據相鄰，因此該范圍被視為A1:E數據表的一部分。 這會導致 API 將數據附加到 A 列。

您可以通過創建另一個工作表來驗證這一點，僅填充單元格B1:E2並執行 API。

例子：

在這里我使用B:E作為范圍

在執行 Append API 之前：

執行 Append API 后

在您的情況下，您需要明確定義范圍 (B3:E3) 中的行號，並且該范圍必須為空，否則它會將其數據附加到所提供范圍下方的第一個空行。

參考：

• 方法：spreadsheets.values.append