Google电子表格API：单元格中的注释

Question

我做了一个PHP脚本，使用api v4将一些信息导出到谷歌电子表格。当我尝试向单元格中添加注释时，我应该为每个注释向API发出请求，这对我来说是一个问题，前面已经解释过了。

我目前的方法是以下一种，我试图在单行的每一列上添加注释（$HeaderNotes是一个数组）：

public function writeHeaderNotes($headerNotes, $spreadsheetId, $sheetId, $row)
{
    $client = $this->getClient();
    $service = new Google_Service_Sheets($client);
    $cellstart = 0;
    $cellend = 1;

    foreach ($headerNotes as $note)
    {
        $body = new Google_Service_Sheets_BatchUpdateSpreadsheetRequest(array(
            'requests' => array(
                'updateCells' => array(
                    'rows' => array(
                        'values' => array(
                            'note' => $note)),
                    'fields' => 'note',
                    'range' => array(
                        'sheetId' => $sheetId,
                        'startRowIndex' => $row-1,
                        'endRowIndex' => $row,
                        'startColumnIndex' => $cellstart,
                        'endColumnIndex' => $cellend)))
        ));
        $service->spreadsheets->batchUpdate($spreadsheetId, $body);
        $cellstart++;
        $cellend++;
    }

}

在这种方法中，注释是一个接一个地添加的（使用循环），并且工作正常。主要的问题是，我做的请求和notes一样多，而谷歌的Cuota有限。（每100秒每个用户有100个写入请求）。我需要优化请求的数量，我只需要发出一个请求，在同一行的不同单元格中添加不同的注释。阅读google电子表格文档，我可以看到请求中的“note”节点正在请求字符串值：

  "note": string,

https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/request#updatecellsrequesthttps://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/sheets#RowDatahttps://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/cells#CellData

如何在不同的单行单元格中添加不同的注释，而不需要发出这么多请求？

Answer 1

如RowData对象[1]的文档所述，values字段是一个数组，其中每个值（CellData对象）都是要插入到每个单元格中的值。您还需要使用一个范围，该范围可以覆盖要在每行中插入的所有值。我修改并测试了您的代码，在第一行的前5列中插入注释，并成功地工作：

$client = getClient();
$service = new Google_Service_Sheets($client);
$cellstart = 0;
$cellend = 5;
$note = "whatever";
$row = 1;

$body = new Google_Service_Sheets_BatchUpdateSpreadsheetRequest(array(
    'requests' => array(
        'updateCells' => array(
            'rows' => array(
                'values' => array(
                    array('note' => $note),
                    array('note' => $note),
                    array('note' => $note),
                    array('note' => $note),
                    array('note' => $note)
                )
            ),
            'fields' => 'note',
            'range' => array(
                'sheetId' => $sheetId,
                'startRowIndex' => $row-1,
                'endRowIndex' => $row,
                'startColumnIndex' => $cellstart,
                'endColumnIndex' => $cellend
            )
        )
    )
));
$service->spreadsheets->batchUpdate($spreadsheetId, $body)

[1]https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/sheets#RowData