DataFilter

Filter, der beschreibt, welche Daten aus einer Anfrage ausgewählt oder zurückgegeben werden sollen.

JSON-Darstellung 
{

  // Union field filter can be only one of the following:
  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
  // End of list of possible types for union field filter.
}
Felder
Union-Feld filter. Die Arten von Filtern, die die Auswahl der 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 verknüpft sind, 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 mit dem in GridRange beschriebenen Bereich übereinstimmen.

DeveloperMetadataLookup

Wählt DeveloperMetadata aus, das mit allen angegebenen Feldern übereinstimmt. Wenn zum Beispiel nur eine Metadaten-ID angegeben ist, wird DeveloperMetadata mit dieser eindeutigen ID berücksichtigt. Wenn ein Metadatenschlüssel angegeben ist, werden alle Entwicklermetadaten mit diesem Schlüssel berücksichtigt. Sind Schlüssel, Sichtbarkeit und Standorttyp angegeben, werden alle Entwicklermetadaten mit diesem Schlüssel und dieser Sichtbarkeit berücksichtigt, die mit einem Standort dieses Typs verknüpft sind. Im Allgemeinen werden dadurch alle DeveloperMetadata ausgewählt, die mit der Schnittmenge aller angegebenen Felder übereinstimmen. Alle Felder oder Kombinationen von Feldern können 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 die 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 Standorttypen berücksichtigt. Dieses Feld kann nicht als SPREADSHEET angegeben werden, wenn locationMatchingStrategy als INTERSECTING angegeben ist oder metadataLocation als Nicht-Tabelle angegeben ist: Tabellenmetadaten dürfen sich nicht mit anderen Speicherorten von Entwicklermetadaten überschneiden. Dieses Feld darf auch nicht angegeben werden, wenn locationMatchingStrategy als GENAU angegeben ist.
metadataLocation

object (DeveloperMetadataLocation)

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

enum (DeveloperMetadataLocationMatchingStrategy)

Bestimmt, wie dieser Lookup mit dem Standort übereinstimmt. Wenn dieses Feld als GENAU angegeben ist, werden nur Entwicklermetadaten abgeglichen, die mit dem angegebenen Standort verknüpft sind. Wenn dieses Feld auf INTERSECTING festgelegt ist, werden auch die Entwicklermetadaten abgeglichen, die sich auf überschneidende Standorte beziehen. Wenn keine Angabe erfolgt, wird in diesem Feld der Standardwert INTERSECTING verwendet. Wenn dieses Feld angegeben ist, muss auch ein metadataLocation angegeben werden.
metadataId

integer

Beschränkt die ausgewählten Entwicklermetadaten auf die Metadaten, die eine entsprechende DeveloperMetadata.metadata_id haben.
metadataKey

string

Beschränkt die ausgewählten Entwicklermetadaten auf die Metadaten, die eine entsprechende DeveloperMetadata.metadata_key haben.
metadataValue

string

Beschränkt die ausgewählten Entwicklermetadaten auf die Metadaten, die eine entsprechende DeveloperMetadata.metadata_value haben.
visibility

enum (DeveloperMetadataVisibility)

Beschränkt die ausgewählten Entwicklermetadaten auf die Metadaten, die eine entsprechende DeveloperMetadata.visibility haben. Wenn keine Angabe erfolgt, werden alle Entwicklermetadaten berücksichtigt, die für das anfragende Projekt sichtbar sind.

DeveloperMetadataLocationMatchingStrategy

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

Enums
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED Standardwert. Dieser Wert darf nicht verwendet werden.
EXACT_LOCATION Gibt an, dass ein bestimmter Standort genau abgeglichen werden soll. Wenn beispielsweise Zeile 3 als Standort angegeben ist, stimmen die Abgleichsstrategien nur mit den Entwicklermetadaten aus Zeile 3 überein. Metadaten, die mit anderen Speicherorten verknüpft sind, werden nicht berücksichtigt.
INTERSECTING_LOCATION Gibt an, dass ein bestimmter Standort genau mit diesem übereinstimmen muss und sich außerdem überschneidende Standorte umfassen müssen. Wenn beispielsweise Zeile 3 als Standort angegeben ist, stimmen die Abgleichsstrategie mit den Entwicklermetadaten aus Zeile 3 und mit Standorten, die Zeile 3 überschneiden, überein. Wenn beispielsweise Spalte B Entwicklermetadaten zugeordnet sind, würde diese Zuordnungsstrategie ebenfalls mit diesem Standort übereinstimmen, da Spalte B Zeile 3 überschneidet.