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)

レスポンスの日付、時刻、期間をレンダリングする方法を決定します。responseValueRenderOptionFORMATTED_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 新しいデータに対応する行が挿入されます。