Method: spreadsheets.developerMetadata.search

Gibt alle Entwicklermetadaten zurück, die mit dem angegebenen DataFilter übereinstimmen. Weitere Informationen finden Sie unter Metadaten lesen, schreiben und durchsuchen.

Wenn das bereitgestellte DataFilter ein DeveloperMetadataLookup-Objekt darstellt, werden alle damit ausgewählten DeveloperMetadata-Einträge zurückgegeben. Wenn DataFilter einen Ort in einer Tabelle darstellt, werden alle Entwicklermetadaten zurückgegeben, die mit Orten verknüpft sind, die sich mit dieser Region überschneiden.

HTTP-Anfrage

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/developerMetadata:search

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

Die ID der Tabelle, aus der Metadaten abgerufen werden sollen.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Felder
dataFilters[]

object (DataFilter)

Die Datenfilter, die die Kriterien beschreiben, anhand derer bestimmt wird, welche DeveloperMetadata-Einträge zurückgegeben werden. DeveloperMetadata, die einem der angegebenen Filter entsprechen, werden in die Antwort aufgenommen.

Antworttext

Eine Antwort auf eine Suchanfrage nach Entwicklermetadaten.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "matchedDeveloperMetadata": [
    {
      object (MatchedDeveloperMetadata)
    }
  ]
}
Felder
matchedDeveloperMetadata[]

object (MatchedDeveloperMetadata)

Die Metadaten, die den Kriterien der Suchanfrage entsprechen.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

Weitere Informationen finden Sie im Autorisierungsleitfaden.

MatchedDeveloperMetadata

Ein Entwicklermetadateneintrag und die in der ursprünglichen Anfrage angegebenen Datenfilter, die dazu passen.

JSON-Darstellung 
{
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Felder
developerMetadata

object (DeveloperMetadata)

Die Entwicklermetadaten, die den angegebenen Filtern entsprechen.
dataFilters[]

object (DataFilter)

Alle Filter, die den zurückgegebenen Entwicklermetadaten entsprechen.