スプレッドシートから 1 つ以上の値の範囲を返します。呼び出し元には、スプレッドシート ID と範囲を 1 つ以上指定する必要があります。
HTTP リクエスト
GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
spreadsheetId |
データを取得するスプレッドシートの ID。 |
クエリ パラメータ
パラメータ | |
---|---|
ranges[] |
値を取得する範囲の A1 表記または R1C1 表記。 |
majorDimension |
結果で使用される主要なディメンション。 たとえば、スプレッドシート データが |
valueRenderOption |
出力での値の表示方法。デフォルトのレンダリング オプションは |
dateTimeRenderOption |
出力で日付、時刻、期間をどのように表すか。 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
スプレッドシートで複数の値の範囲を取得するときのレスポンス。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
フィールド | |
---|---|
spreadsheetId |
データの取得元のスプレッドシートの ID。 |
valueRanges[] |
リクエストされた値。ValueRanges の順序は、リクエストされた範囲の順序と同じです。 |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/spreadsheets.readonly
詳しくは、認可ガイドをご覧ください。