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