Method: spreadsheets.developerMetadata.search

Gibt alle Entwicklermetadaten zurück, die mit dem angegebenen DataFilter übereinstimmen. Wenn der angegebene DataFilter ein DeveloperMetadataLookup-Objekt darstellt, werden hiermit alle über ihn ausgewählten DeveloperMetadata-Einträge zurückgegeben. Wenn der DataFilter einen Standort in einer Tabelle darstellt, werden damit 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, mit denen die Kriterien beschrieben werden, mit denen festgelegt wird, welche DeveloperMetadata-Einträge zurückgegeben werden sollen. DeveloperMetadata, die mit einem der angegebenen Filter übereinstimmen, sind in der Antwort enthalten.

Antworttext

Eine Antwort auf eine Suchanfrage nach Entwicklermetadaten.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender 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 in der ursprünglichen Anfrage angegebenen Datenfilter.

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.