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 新しいデータの行が挿入されます。