Method: spreadsheets.developerMetadata.search

Gibt alle Entwicklermetadaten zurück, die mit der angegebenen DataFilter übereinstimmen. Wenn der bereitgestellte DataFilter ein DeveloperMetadataLookup-Objekt darstellt, werden alle von ihm ausgewählten DeveloperMetadata-Einträge zurückgegeben. Wenn der DataFilter einen Standort in einer Tabelle darstellt, werden alle Entwicklermetadaten zurückgegeben, die mit Standorten 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 die zurückzugebenden DeveloperMetadata-Einträge ermittelt werden. DeveloperMetadata, die mit einem der angegebenen Filter übereinstimmen, sind in der Antwort enthalten.

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 Leitfaden zur Autorisierung.

MatchedDeveloperMetadata

Ein Entwicklermetadateneintrag und die Datenfilter, die in der ursprünglichen Anfrage angegeben und mit ihm übereinstimmen.

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 mit den zurückgegebenen Entwicklermetadaten übereinstimmen.