DataFilter

요청에서 선택하거나 반환해야 하는 데이터를 설명하는 필터입니다.

JSON 표현
{

  // Union field filter can be only one of the following:
  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
  // End of list of possible types for union field filter.
}
필드
통합 필드 filter는 선택할 수 있는 데이터를 제한할 수 있는 필터의 종류 filter은 다음 중 하나여야 합니다.
developerMetadataLookup

object (DeveloperMetadataLookup)

DeveloperMetadataLookup에 설명된 기준과 일치하는 개발자 메타데이터와 연결된 데이터를 선택합니다.

a1Range

string

지정된 A1 범위와 일치하는 데이터를 선택합니다.

gridRange

object (GridRange)

GridRange에 설명된 범위와 일치하는 데이터를 선택합니다.

개발자 메타데이터 조회

지정된 모든 필드와 일치하는 DeveloperMetadata을 선택합니다. 예를 들어 메타데이터 ID만 지정된 경우 특정 고유 ID가 있는 DeveloperMetadata로 간주됩니다. 메타데이터 키가 지정되면 해당 키가 있는 모든 개발자 메타데이터를 고려합니다. 키, 공개 상태, 위치 유형을 모두 지정하면 해당 유형의 위치와 연결된 키 및 공개 상태가 있는 모든 개발자 메타데이터가 고려됩니다. 일반적으로 이렇게 하면 지정된 모든 필드의 교집합과 일치하는 모든 DeveloperMetadata가 선택됩니다. 필드 또는 필드 조합을 지정할 수 있습니다.

JSON 표현
{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}
필드
locationType

enum (DeveloperMetadataLocationType)

선택한 개발자 메타데이터를 지정된 유형의 위치와 연결된 항목으로 제한합니다. 예를 들어 이 필드가 ROW로 지정되면 이 조회에서는 행과 관련된 개발자 메타데이터만 고려합니다. 필드를 지정하지 않으면 모든 위치 유형이 고려됩니다. locationMatchingStrategy가 INTERSECTING로 지정되었거나 metadataLocation가 스프레드시트가 아닌 위치로 지정된 경우 이 필드를 SPREADSHEET로 지정할 수 없습니다. 스프레드시트 메타데이터는 다른 개발자 메타데이터 위치와 교차될 수 없습니다. locationMatchingStrategy가 EXACT로 지정된 경우 이 필드도 지정되지 않은 상태로 두어야 합니다.

metadataLocation

object (DeveloperMetadataLocation)

선택한 개발자 메타데이터를 지정된 위치와 연결된 항목으로 제한합니다. 이 필드는 지정된 locationMatchingStrategy에 따라 정확한 위치 또는 모든 교차 위치와 일치합니다.

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

이 조회가 위치와 일치하는 방식을 결정합니다. 이 필드가 EXACT로 지정되면 지정된 정확한 위치와 연결된 개발자 메타데이터만 일치합니다. 이 필드가 INTERSECTING(으)로 지정되면 교차 위치와 연결된 개발자 메타데이터도 일치됩니다. 지정하지 않으면 이 필드가 기본값 INTERSECTING로 가정합니다. 이 필드를 지정하면 metadataLocation도 지정해야 합니다.

metadataId

integer

선택한 개발자 메타데이터를 일치하는 DeveloperMetadata.metadata_id가 있는 메타데이터로 제한합니다.

metadataKey

string

선택한 개발자 메타데이터를 일치하는 DeveloperMetadata.metadata_key가 있는 메타데이터로 제한합니다.

metadataValue

string

선택한 개발자 메타데이터를 일치하는 DeveloperMetadata.metadata_value가 있는 메타데이터로 제한합니다.

visibility

enum (DeveloperMetadataVisibility)

선택한 개발자 메타데이터를 일치하는 DeveloperMetadata.visibility가 있는 메타데이터로 제한합니다. 지정하지 않으면 요청하는 프로젝트에 표시되는 모든 개발자 메타데이터가 고려됩니다.

개발자 메타데이터 위치 일치 전략

개발자 메타데이터 위치 일치를 위한 전략 열거형입니다.

열거형
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED 기본값 이 값은 사용할 수 없습니다.
EXACT_LOCATION 지정된 위치가 정확하게 일치해야 함을 나타냅니다. 예를 들어 3행이 위치로 지정되면 이 일치 전략은 3행과도 연결된 개발자 메타데이터와만 일치합니다. 다른 위치와 관련된 메타데이터는 고려되지 않습니다.
INTERSECTING_LOCATION 지정된 위치가 해당 위치 및 교차하는 위치와 일치해야 합니다. 예를 들어 3행이 위치로 지정되면 이 일치 전략은 3행과 연결된 개발자 메타데이터와 3행과 교차되는 위치와 연결된 메타데이터를 일치시킵니다. 예를 들어 B열과 연결된 개발자 메타데이터가 있는 경우 B열이 3행과 교차되므로 이 일치 전략은 해당 위치와도 일치합니다.