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étodo | Tipo de retorno | Breve descrição |
|---|---|---|
find() | DeveloperMetadata[] | Executa essa pesquisa e retorna os metadados correspondentes. |
onIntersectingLocations() | DeveloperMetadataFinder | Configura a pesquisa para considerar locais de interseção que têm metadados. |
withId(id) | DeveloperMetadataFinder | Limita esta pesquisa para considerar apenas os metadados que correspondem ao ID especificado. |
withKey(key) | DeveloperMetadataFinder | Limita esta pesquisa para considerar apenas os metadados que correspondem à chave especificada. |
withLocationType(locationType) | DeveloperMetadataFinder | Limita esta pesquisa para considerar apenas os metadados que correspondem ao tipo de local especificado. |
withValue(value) | DeveloperMetadataFinder | Limita esta pesquisa para considerar apenas os metadados que correspondem ao valor especificado. |
withVisibility(visibility) | DeveloperMetadataFinder | Limita 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
| Nome | Tipo | Descrição |
|---|---|---|
id | Integer | O 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
| Nome | Tipo | Descrição |
|---|---|---|
key | String | A 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
| Nome | Tipo | Descrição |
|---|---|---|
locationType | DeveloperMetadataLocationType | O 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
| Nome | Tipo | Descrição |
|---|---|---|
value | String | O 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
| Nome | Tipo | Descrição |
|---|---|---|
visibility | DeveloperMetadataVisibility | A visibilidade a ser correspondida ao pesquisar metadados. |
Retorno
DeveloperMetadataFinder: localizador de metadados do desenvolvedor para encadeamento.