DataFilter

Filter, der beschreibt, welche Daten ausgewählt oder von einer Anfrage 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 dieser DeveloperMetadataLookup beschriebenen Kriterien entsprechen.
a1Range

string

Wählt Daten aus, die mit dem angegebenen A1-Bereich übereinstimmen.
gridRange

object (GridRange)

Wählt Daten aus, die dem durch GridRange beschriebenen Bereich entsprechen.

DeveloperMetadataLookup

Wählt DeveloperMetadata aus, das mit allen angegebenen Feldern übereinstimmt. Wenn beispielsweise 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. Wenn ein Schlüssel, die Sichtbarkeit und der Standorttyp angegeben sind, werden alle Entwicklermetadaten mit diesem Schlüssel und der Sichtbarkeit berücksichtigt, die mit einem Standort dieses Typs verknüpft sind. Dadurch werden in der Regel alle „DeveloperMetadata“ ausgewählt, die mit der Schnittmenge aller angegebenen Felder übereinstimmen. Es kann ein beliebiges Feld oder eine 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)

Begrenzt die ausgewählten Entwicklermetadaten auf die Einträge, die mit Speicherorten des angegebenen Typs verknüpft sind. Wenn dieses Feld beispielsweise als ROW angegeben ist, werden bei dieser Suche nur die mit den Zeilen verknüpften Entwicklermetadaten berücksichtigt. 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 wenn metadataLocation als Speicherort angegeben ist, der keine Tabelle ist: Metadaten von Tabellen dürfen sich nicht mit anderen Speicherorten für Entwicklermetadaten überschneiden. Dieses Feld darf auch nicht angegeben werden, wenn locationMatchingStrategy als EXAKT angegeben wird.
metadataLocation

object (DeveloperMetadataLocation)

Beschränkt die ausgewählten Entwicklermetadaten auf die Einträge, die mit dem angegebenen Speicherort verknüpft sind. In diesem Feld werden entweder exakte Standorte oder alle sich überschneidenden Orte gemäß dem angegebenen locationMatchingStrategy zurückgegeben.
locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Legt fest, wie diese Suche mit dem Standort übereinstimmt. Wenn für dieses Feld die Option EXAKT angegeben ist, werden nur Entwicklermetadaten abgeglichen, die mit dem genauen Standort verknüpft sind. Wenn dieses Feld auf INTERSECTING gesetzt ist, werden auch die mit den sich überschneidenden Standorten verknüpften Entwicklermetadaten abgeglichen. Wenn nicht angegeben, wird in diesem Feld der Standardwert INTERSECTING verwendet. Wenn dieses Feld angegeben wird, muss auch ein metadataLocation angegeben werden.
metadataId

integer

Beschränkt die ausgewählten Entwicklermetadaten auf die Metadaten mit einem übereinstimmenden DeveloperMetadata.metadata_id.
metadataKey

string

Beschränkt die ausgewählten Entwicklermetadaten auf die Metadaten mit einem übereinstimmenden DeveloperMetadata.metadata_key.
metadataValue

string

Beschränkt die ausgewählten Entwicklermetadaten auf die Metadaten mit einem übereinstimmenden DeveloperMetadata.metadata_value.
visibility

enum (DeveloperMetadataVisibility)

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

DeveloperMetadataLocationMatchingStrategy

Eine Aufzählung von Strategien zum Abgleichen von Speicherorten für Entwicklermetadaten.

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 wäre, würde diese Abgleichsstrategie nur die Entwicklermetadaten der Zeile 3 zuordnen. Mit anderen Standorten verknüpfte Metadaten werden nicht berücksichtigt.
INTERSECTING_LOCATION Gibt an, dass ein bestimmter Ort sowohl mit diesem genauen Standort als auch mit sich überschneidenden Standorten übereinstimmen soll. Wenn beispielsweise Zeile 3 als Standort angegeben ist, werden mit dieser Abgleichsstrategie die in Zeile 3 verknüpften Entwicklermetadaten mit den Metadaten der Standorte abgeglichen, die sich in Zeile 3 überschneiden. Wenn beispielsweise mit Spalte B Entwicklermetadaten verknüpft sind, würde diese Abgleichsstrategie auch diesem Standort entsprechen, da sich Spalte B mit Zeile 3 schneidet.