如何在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