Method: spreadsheets.values.append

スプレッドシートに値を追加します。入力範囲は、既存のデータを検索し、その範囲内の「テーブル」を見つけるために使用されます。値は、テーブルの最初の列から、テーブルの次の行に追加されます。テーブルの検出方法とデータの追加方法について詳しくは、ガイドとサンプルコードをご覧ください。

呼び出し元は、スプレッドシート ID、範囲、valueInputOption を指定する必要があります。valueInputOption は、入力データがシートに追加される方法（列単位または行単位）のみを制御します。データの書き込みが開始されるセルには影響しません。

HTTP リクエスト

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
spreadsheetId

string

更新するスプレッドシートの ID。
range

string

データの論理テーブルを検索する範囲の A1 表記。値はテーブルの最後の行の後に追加されます。

クエリ パラメータ

パラメータ
valueInputOption

enum (ValueInputOption)

入力データをどのように解釈するか。
insertDataOption

enum (InsertDataOption)

入力データを挿入する方法。
includeValuesInResponse

boolean

更新レスポンスに追加されたセルの値を含めるかどうかを決定します。デフォルトでは、レスポンスには更新された値は含まれません。
responseValueRenderOption

enum (ValueRenderOption)

レスポンスの値のレンダリング方法を決定します。デフォルトのレンダリング オプションは FORMATTED_VALUE です。
responseDateTimeRenderOption

enum (DateTimeRenderOption)

レスポンスの日付、時刻、所要時間のレンダリング方法を決定します。responseValueRenderOption が FORMATTED_VALUE の場合、これは無視されます。デフォルトの dateTime レンダリング オプションは SERIAL_NUMBER です。

リクエストの本文

リクエストの本文には ValueRange のインスタンスが含まれます。

レスポンスの本文

スプレッドシート内の値の範囲を更新した場合のレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
フィールド
spreadsheetId

string

更新が適用されたスプレッドシート。
tableRange

string

値が追加されるテーブルの範囲（A1 表記）。テーブルが見つからなかった場合は空になります。
updates

object (UpdateValuesResponse)

適用された更新に関する情報。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

詳しくは、認可ガイドをご覧ください。

InsertDataOption

新しいデータが入力されたときに既存のデータがどのように変更されるかを決定します。

列挙型
OVERWRITE 新しいデータは、書き込まれた領域の既存のデータを上書きします。（注: シートの末尾にデータを追加すると、データが書き込まれるように新しい行または列が挿入されます）。
INSERT_ROWS 新しいデータの行が挿入されます。