DataFilter

Filter, der beschreibt, welche Daten aus einer Anfrage ausgewählt oder zurückgegeben werden sollen. Weitere Informationen finden Sie unter Metadaten lesen, schreiben und durchsuchen.

JSON-Darstellung 
{

  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
}
Felder
Union-Feld filter. Die Arten von Filtern, die die Auswahl von Daten einschränken können. Für filter ist nur einer der folgenden Werte zulässig:
developerMetadataLookup

object (DeveloperMetadataLookup)

Wählt Daten aus, die mit den Entwicklermetadaten übereinstimmen, die den in diesem DeveloperMetadataLookup beschriebenen Kriterien entsprechen.
a1Range

string

Wählt Daten aus, die dem angegebenen A1-Bereich entsprechen.
gridRange

object (GridRange)

Wählt Daten aus, die dem Bereich entsprechen, der durch GridRange beschrieben wird.

DeveloperMetadataLookup

Wählt DeveloperMetadata aus, das allen angegebenen Feldern entspricht. Wenn beispielsweise nur eine Metadaten-ID angegeben ist, wird die DeveloperMetadata mit dieser eindeutigen ID berücksichtigt. Wenn ein Metadatenschlüssel angegeben ist, werden alle Entwicklermetadaten mit diesem Schlüssel berücksichtigt. Wenn ein Schlüssel, eine Sichtbarkeit und ein Standorttyp angegeben sind, werden alle Entwicklermetadaten mit diesem Schlüssel und dieser Sichtbarkeit berücksichtigt, die einem Standort dieses Typs zugeordnet sind. Im Allgemeinen werden damit alle DeveloperMetadata ausgewählt, die der Schnittmenge aller angegebenen Felder entsprechen. Es kann ein beliebiges Feld oder eine beliebige Kombination von Feldern angegeben werden.

JSON-Darstellung 
{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}
Felder
locationType

enum (DeveloperMetadataLocationType)

Beschränkt die ausgewählten Entwicklermetadaten auf Einträge, die mit Standorten des angegebenen Typs verknüpft sind. Wenn dieses Feld beispielsweise als ROW angegeben ist, werden bei dieser Suche nur Entwicklermetadaten berücksichtigt, die mit Zeilen verknüpft sind. Wenn das Feld nicht angegeben ist, werden alle Standorte berücksichtigt. Dieses Feld kann nicht als SPREADSHEET angegeben werden, wenn locationMatchingStrategy als INTERSECTING angegeben ist oder wenn metadataLocation als Speicherort angegeben ist, der kein Tabellenblatt ist. Die Metadaten der Tabelle dürfen sich nicht mit anderen Orten für Entwicklermetadaten überschneiden. Dieses Feld muss auch nicht angegeben werden, wenn locationMatchingStrategy als EXACT angegeben ist.
metadataLocation

object (DeveloperMetadataLocation)

Beschränkt die ausgewählten Entwicklermetadaten auf Einträge, die mit dem angegebenen Standort verknüpft sind. Dieses Feld entspricht entweder genauen Standorten oder allen sich überschneidenden Standorten gemäß der angegebenen locationMatchingStrategy.
locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Legt fest, wie diese Suche mit dem Standort übereinstimmt. Wenn dieses Feld als „EXACT“ angegeben ist, werden nur Entwicklermetadaten abgeglichen, die mit dem angegebenen genauen Standort verknüpft sind. Wenn dieses Feld auf INTERSECTING festgelegt ist, werden auch Entwicklermetadaten abgeglichen, die mit sich überschneidenden Standorten verknüpft sind. Wenn dieses Feld nicht angegeben wird, wird standardmäßig der Wert INTERSECTING verwendet. Wenn dieses Feld angegeben ist, muss auch ein metadataLocation angegeben werden.
metadataId

integer

Beschränkt die ausgewählten Entwicklermetadaten auf diejenigen, die eine übereinstimmende DeveloperMetadata.metadata_id haben.
metadataKey

string

Beschränkt die ausgewählten Entwicklermetadaten auf diejenigen, die eine übereinstimmende DeveloperMetadata.metadata_key haben.
metadataValue

string

Beschränkt die ausgewählten Entwicklermetadaten auf diejenigen, die eine übereinstimmende DeveloperMetadata.metadata_value haben.
visibility

enum (DeveloperMetadataVisibility)

Beschränkt die ausgewählten Entwicklermetadaten auf diejenigen, die eine übereinstimmende DeveloperMetadata.visibility haben. Wenn nichts angegeben ist, werden alle Entwicklermetadaten berücksichtigt, die für das anfragende Projekt sichtbar sind.

DeveloperMetadataLocationMatchingStrategy

Eine Aufzählung von Strategien für den Abgleich von Standorten von Entwicklermetadaten.

Enums
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED Standardwert. Dieser Wert darf nicht verwendet werden.
EXACT_LOCATION Gibt an, dass ein angegebener Standort genau übereinstimmen muss. Wenn beispielsweise Zeile 3 als Standort angegeben wurde, werden mit dieser Abgleichsstrategie nur Entwicklermetadaten abgeglichen, die auch mit Zeile 3 verknüpft sind. Metadaten, die mit anderen Standorten verknüpft sind, werden nicht berücksichtigt.
INTERSECTING_LOCATION Gibt an, dass ein angegebener Standort mit diesem genauen Standort sowie allen sich überschneidenden Standorten übereinstimmen muss. Wenn beispielsweise Zeile 3 als Standort angegeben wurde, werden mit dieser Abgleichsstrategie sowohl Entwicklermetadaten, die mit Zeile 3 verknüpft sind, als auch Metadaten, die mit Standorten verknüpft sind, die Zeile 3 überschneiden, abgeglichen. Wenn beispielsweise Entwicklermetadaten mit Spalte B verknüpft wären, würde diese Matching-Strategie auch diesen Ort abgleichen, da sich Spalte B mit Zeile 3 schneidet.