Method: spreadsheets.values.batchGetByDataFilter

지정된 데이터 필터와 일치하는 값 범위를 하나 이상 반환합니다. 호출자는 스프레드시트 ID와 하나 이상의 DataFilters를 지정해야 합니다. 요청의 데이터 필터와 일치하는 범위가 반환됩니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
spreadsheetId

string

데이터를 검색할 스프레드시트의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "majorDimension": enum (Dimension),
  "valueRenderOption": enum (ValueRenderOption),
  "dateTimeRenderOption": enum (DateTimeRenderOption)
}
필드
dataFilters[]

object (DataFilter)

검색할 값의 범위를 일치시키는 데 사용되는 데이터 필터입니다. 지정된 데이터 필터와 일치하는 범위가 응답에 포함됩니다.
majorDimension

enum (Dimension)

결과에서 사용해야 하는 주요 측정기준입니다.

예를 들어 스프레드시트 데이터가 A1=1,B1=2,A2=3,B2=4인 경우 해당 범위를 선택하고 majorDimension=ROWS을 설정하는 요청은 [[1,2],[3,4]]을 반환하는 반면 majorDimension=COLUMNS를 설정하는 요청은 [[1,3],[2,4]]를 반환합니다.
valueRenderOption

enum (ValueRenderOption)

출력에 값이 표시되는 방식입니다. 기본 렌더링 옵션은 FORMATTED_VALUE입니다.
dateTimeRenderOption

enum (DateTimeRenderOption)

출력에 날짜, 시간, 기간이 표시되는 방식입니다. valueRenderOption가 FORMATTED_VALUE이면 무시됩니다. 기본 dateTime 렌더링 옵션은 SERIAL_NUMBER입니다.

응답 본문

DataFilters에서 선택한 스프레드시트에서 값 범위를 두 개 이상 검색할 때의 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (MatchedValueRange)
    }
  ]
}
필드
spreadsheetId

string

데이터를 가져온 스프레드시트의 ID입니다.
valueRanges[]

object (MatchedValueRange)

요청된 값과 일치하는 데이터 필터 목록입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 승인 가이드를 참조하세요.

MatchedValueRange

하나 이상의 데이터 파일러와 일치하는 값 범위입니다.

JSON 표현 
{
  "valueRange": {
    object (ValueRange)
  },
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
필드
valueRange

object (ValueRange)

DataFilter와 일치하는 값입니다.
dataFilters[]

object (DataFilter)

값 범위와 일치하는 요청의 DataFilters입니다.