スプレッドシートに値を追加します。入力範囲は、既存のデータを検索し、その範囲内の「テーブル」を見つけるために使用されます。値は、表の最初の列から表の次の行に追加されます。テーブルを検出してデータを追加する方法について詳しくは、ガイドとサンプルコードをご覧ください。
呼び出し元は、スプレッドシート ID、範囲、valueInputOption
を指定する必要があります。valueInputOption
は、入力データをシートに追加する方法(列単位または行単位)のみを制御します。データの書き込みを開始するセルには影響しません。
HTTP リクエスト
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
spreadsheetId |
更新するスプレッドシートの ID。 |
range |
データの論理表を検索する範囲の A1 表記。値はテーブルの最終行の後に追加されます。 |
クエリ パラメータ
パラメータ | |
---|---|
valueInputOption |
入力データの解釈方法。 |
insertDataOption |
入力データの挿入方法。 |
includeValuesInResponse |
追加されたセルの値を更新レスポンスに含めるかどうかを指定します。デフォルトでは、更新された値はレスポンスに含まれません。 |
responseValueRenderOption |
レスポンス内の値のレンダリング方法を決定します。デフォルトのレンダリング オプションは |
responseDateTimeRenderOption |
レスポンスの日付、時刻、期間をどのようにレンダリングするかを決定します。 |
リクエスト本文
リクエストの本文には ValueRange
のインスタンスが含まれています。
レスポンスの本文
スプレッドシートの値の範囲を更新したときのレスポンス。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
フィールド | |
---|---|
spreadsheetId |
更新が適用されたスプレッドシート。 |
tableRange |
値が追加されるテーブルの範囲(A1 表記)。値が追加される前です。テーブルが見つからなかった場合は空になります。 |
updates |
適用された更新に関する情報。 |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
詳しくは、承認ガイドをご覧ください。
InsertDataOption
新しいデータが入力されたときに既存のデータをどのように変更するかを決定します。
列挙型 | |
---|---|
OVERWRITE |
新しいデータによって、書き込まれた領域の既存のデータが上書きされます。(注: シートの末尾にデータを追加しても新しい行または列が挿入されるため、データを書き込むことができます)。 |
INSERT_ROWS |
新しいデータの行が挿入されます。 |