Class DeveloperMetadataFinder

DeveloperMetadataFinder

Pesquise os metadados do desenvolvedor em uma planilha. Para criar um novo localizador de metadados do desenvolvedor, use Range.createDeveloperMetadataFinder(), Sheet.createDeveloperMetadataFinder() ou Spreadsheet.createDeveloperMetadataFinder().

Métodos

MétodoTipo de retornoBreve descrição
find()DeveloperMetadata[]Executa essa pesquisa e retorna os metadados correspondentes.
onIntersectingLocations()DeveloperMetadataFinderConfigura a pesquisa para considerar locais de interseção que têm metadados.
withId(id)DeveloperMetadataFinderLimita esta pesquisa para considerar apenas os metadados que correspondem ao ID especificado.
withKey(key)DeveloperMetadataFinderLimita esta pesquisa para considerar apenas os metadados que correspondem à chave especificada.
withLocationType(locationType)DeveloperMetadataFinderLimita esta pesquisa para considerar apenas os metadados que correspondem ao tipo de local especificado.
withValue(value)DeveloperMetadataFinderLimita esta pesquisa para considerar apenas os metadados que correspondem ao valor especificado.
withVisibility(visibility)DeveloperMetadataFinderLimita esta pesquisa para considerar apenas os metadados que correspondem à visibilidade especificada.

Documentação detalhada

find()

Executa essa pesquisa e retorna os metadados correspondentes.

Retorno

DeveloperMetadata[]: os metadados do desenvolvedor que correspondem aos critérios de pesquisa.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

onIntersectingLocations()

Configura a pesquisa para considerar locais de interseção que têm metadados. Essa opção é válida apenas para pesquisas com escopo de intervalo.

Retorno

DeveloperMetadataFinder: localizador de metadados do desenvolvedor para encadeamento.


withId(id)

Limita esta pesquisa para considerar apenas os metadados que correspondem ao ID especificado.

Parâmetros

NomeTipoDescrição
idIntegerO ID a ser correspondido ao pesquisar metadados.

Retorno

DeveloperMetadataFinder: localizador de metadados do desenvolvedor para encadeamento.


withKey(key)

Limita esta pesquisa para considerar apenas os metadados que correspondem à chave especificada.

Parâmetros

NomeTipoDescrição
keyStringA chave a ser correspondida ao pesquisar metadados.

Retorno

DeveloperMetadataFinder: localizador de metadados do desenvolvedor para encadeamento.


withLocationType(locationType)

Limita esta pesquisa para considerar apenas os metadados que correspondem ao tipo de local especificado.

Parâmetros

NomeTipoDescrição
locationTypeDeveloperMetadataLocationTypeO tipo de local a ser correspondido ao pesquisar metadados.

Retorno

DeveloperMetadataFinder: localizador de metadados do desenvolvedor para encadeamento.


withValue(value)

Limita esta pesquisa para considerar apenas os metadados que correspondem ao valor especificado.

Parâmetros

NomeTipoDescrição
valueStringO valor a ser correspondido ao pesquisar metadados.

Retorno

DeveloperMetadataFinder: localizador de metadados do desenvolvedor para encadeamento.


withVisibility(visibility)

Limita esta pesquisa para considerar apenas os metadados que correspondem à visibilidade especificada.

Parâmetros

NomeTipoDescrição
visibilityDeveloperMetadataVisibilityA visibilidade a ser correspondida ao pesquisar metadados.

Retorno

DeveloperMetadataFinder: localizador de metadados do desenvolvedor para encadeamento.