DataFilter

Filtro que descreve quais dados devem ser selecionados ou retornados de uma solicitação. Para mais informações, consulte Ler, gravar e pesquisar metadados.

Representação JSON
{

  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
}
Campos
Campo de união filter. Os tipos de filtros que podem limitar os dados selecionados. filter pode ser apenas de um dos tipos a seguir:
developerMetadataLookup

object (DeveloperMetadataLookup)

Seleciona os dados associados aos metadados do desenvolvedor que correspondem aos critérios descritos por este DeveloperMetadataLookup.

a1Range

string

Seleciona dados que correspondem ao intervalo A1 especificado.

gridRange

object (GridRange)

Seleciona dados que correspondem ao intervalo descrito pelo GridRange.

DeveloperMetadataLookup

Seleciona DeveloperMetadata que corresponde a todos os campos especificados. Por exemplo, se apenas um ID de metadados for especificado, isso vai considerar o DeveloperMetadata com esse ID exclusivo específico. Se uma chave de metadados for especificada, todos os metadados do desenvolvedor com essa chave serão considerados. Se uma chave, uma visibilidade e um tipo de local forem especificados, isso vai considerar todos os metadados do desenvolvedor com essa chave e visibilidade associados a um local desse tipo. Em geral, isso seleciona todos os DeveloperMetadata que correspondem à interseção de todos os campos especificados. Qualquer campo ou combinação de campos pode ser especificado.

Representação JSON
{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}
Campos
locationType

enum (DeveloperMetadataLocationType)

Limita os metadados do desenvolvedor selecionados às entradas associadas a locais do tipo especificado. Por exemplo, quando esse campo é especificado como ROW, essa pesquisa considera apenas os metadados do desenvolvedor associados às linhas. Se o campo não for especificado, todos os tipos de local serão considerados. Esse campo não pode ser especificado como SPREADSHEET quando locationMatchingStrategy é especificado como INTERSECTING ou quando metadataLocation é especificado como um local que não é uma planilha. Os metadados da planilha não podem se cruzar com nenhum outro local de metadados do desenvolvedor. Esse campo também precisa ser deixado sem especificação quando locationMatchingStrategy é definido como EXACT.

metadataLocation

object (DeveloperMetadataLocation)

Limita os metadados do desenvolvedor selecionados às entradas associadas ao local especificado. Esse campo corresponde a locais exatos ou a todos os locais que se cruzam, de acordo com o locationMatchingStrategy especificado.

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Determina como essa pesquisa corresponde ao local. Se este campo for especificado como "EXACT", apenas os metadados do desenvolvedor associados ao local exato especificado serão correspondentes. Se esse campo for especificado como INTERSECTING, os metadados do desenvolvedor associados a locais de interseção também serão correspondentes. Se não for especificado, esse campo vai assumir o valor padrão INTERSECTING. Se esse campo for especificado, um metadataLocation também precisará ser especificado.

metadataId

integer

Limita os metadados do desenvolvedor selecionados àqueles que têm um DeveloperMetadata.metadata_id correspondente.

metadataKey

string

Limita os metadados do desenvolvedor selecionados àqueles que têm um DeveloperMetadata.metadata_key correspondente.

metadataValue

string

Limita os metadados do desenvolvedor selecionados àqueles que têm um DeveloperMetadata.metadata_value correspondente.

visibility

enum (DeveloperMetadataVisibility)

Limita os metadados do desenvolvedor selecionados àqueles que têm um DeveloperMetadata.visibility correspondente. Se não for especificado, todos os metadados do desenvolvedor visíveis para o projeto solicitante serão considerados.

DeveloperMetadataLocationMatchingStrategy

Uma enumeração de estratégias para corresponder a locais de metadados do desenvolvedor.

Tipos enumerados
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED Valor padrão. Esse valor não pode ser usado.
EXACT_LOCATION Indica que um local especificado precisa ser correspondido exatamente. Por exemplo, se a linha três fosse especificada como um local, essa estratégia de correspondência só encontraria metadados do desenvolvedor também associados à linha três. Metadados associados a outros locais não serão considerados.
INTERSECTING_LOCATION Indica que um local especificado precisa corresponder ao local exato e a todos os locais que se cruzam. Por exemplo, se a linha três fosse especificada como um local, essa estratégia de correspondência encontraria os metadados do desenvolvedor associados à linha três, bem como os metadados associados aos locais que se cruzam com a linha três. Por exemplo, se houver metadados do desenvolvedor associados à coluna B, essa estratégia de correspondência também vai corresponder a esse local porque a coluna B cruza a linha três.