Class DeveloperMetadataFinder

Localizador demetadadosdo desenvolvedor

Pesquise 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 com metadados.
withId(id)	DeveloperMetadataFinder	Limita a pesquisa para considerar apenas metadados que correspondem ao ID especificado.
withKey(key)	DeveloperMetadataFinder	Limita a pesquisa para considerar apenas os metadados que correspondem à chave especificada.
withLocationType(locationType)	DeveloperMetadataFinder	Limita a pesquisa para considerar apenas metadados que correspondem ao tipo de local especificado.
withValue(value)	DeveloperMetadataFinder	Limita a pesquisa para considerar apenas metadados que correspondem ao valor especificado.
withVisibility(visibility)	DeveloperMetadataFinder	Limita a pesquisa para considerar apenas os metadados que correspondem à visibilidade especificada.

Documentação detalhada

find()

Executa essa pesquisa e retorna os metadados correspondentes.

Retornar

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 com metadados. Essa opção é válida apenas para pesquisas no escopo do intervalo.

Retornar

DeveloperMetadataFinder: o localizador de metadados do desenvolvedor para encadeamento.

---

withId(id)

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

Parâmetros

Nome	Tipo	Descrição
id	Integer	O ID a ser usado na pesquisa de metadados.

Retornar

DeveloperMetadataFinder: o localizador de metadados do desenvolvedor para encadeamento.

---

withKey(key)

Limita a 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.

Retornar

DeveloperMetadataFinder: o localizador de metadados do desenvolvedor para encadeamento.

---

withLocationType(locationType)

Limita a pesquisa para considerar apenas 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.

Retornar

DeveloperMetadataFinder: o localizador de metadados do desenvolvedor para encadeamento.

---

withValue(value)

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

Parâmetros

Nome	Tipo	Descrição
value	String	O valor a ser correspondido ao pesquisar metadados.

Retornar

DeveloperMetadataFinder: o localizador de metadados do desenvolvedor para encadeamento.

---

withVisibility(visibility)

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

Parâmetros

Nome	Tipo	Descrição
visibility	DeveloperMetadataVisibility	A visibilidade a ser usada ao pesquisar metadados.

Retornar

DeveloperMetadataFinder: o localizador de metadados do desenvolvedor para encadeamento.