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 und den in dieser 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 in GridRange beschriebenen Bereich entsprechen.

DeveloperMetadataLookup

Wählt DeveloperMetadata aus, die mit allen angegebenen Feldern übereinstimmt. 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, 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. In der Regel werden dadurch alle DeveloperMetadata ausgewählt, die mit der Schnittmenge aller angegebenen Felder übereinstimmen. Jedes Feld oder eine beliebige Kombination von Feldern kann 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)

Die ausgewählten Entwicklermetadaten werden auf Einträge beschränkt, die mit Standorten des angegebenen Typs verknüpft sind. Wenn dieses Feld beispielsweise als ROW angegeben ist, berücksichtigt diese Suche nur Entwicklermetadaten, die mit Zeilen verknüpft sind. Wenn das Feld leer bleibt, 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, bei dem es sich nicht um einen Tabellenspeicherort handelt. Die Metadaten der Tabelle dürfen sich mit keinem anderen Speicherort der Entwicklermetadaten überschneiden. Dieses Feld muss auch leer bleiben, 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 stimmt entweder mit genauen Standorten oder mit allen sich überschneidenden Standorten gemäß der angegebenen locationMatchingStrategy überein.
locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Bestimmt, wie diese Suche mit dem Standort abgeglichen wird. Wenn dieses Feld als GENAU angegeben ist, werden nur Entwicklermetadaten abgeglichen, die mit dem genau angegebenen Standort verknüpft sind. Wenn für dieses Feld „OVERLAPP“ angegeben ist, werden auch Entwicklermetadaten abgeglichen, die mit sich überschneidenden Standorten verknüpft sind. Wenn nicht angegeben, wird in diesem Feld der Standardwert INTERSECTING verwendet. Wenn dieses Feld angegeben ist, muss auch eine metadataLocation angegeben werden.
metadataId

integer

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

string

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

string

Die ausgewählten Entwicklermetadaten werden auf solche mit übereinstimmender DeveloperMetadata.metadata_value beschränkt.
visibility

enum (DeveloperMetadataVisibility)

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

DeveloperMetadataLocationMatchingStrategy

Eine Aufzählung von Strategien zum Abgleichen von Speicherorten der Entwicklermetadaten.

Enums
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED Standardwert. Dieser Wert darf nicht verwendet werden.
EXACT_LOCATION Gibt an, dass ein bestimmter Standort genau übereinstimmen muss. Wenn beispielsweise Zeile 3 als Standort angegeben wurde, werden mit dieser Abgleichsstrategie nur Entwicklermetadaten abgeglichen, die auch in 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 und allen sich überschneidenden Standorten übereinstimmen muss. Wenn beispielsweise Zeile 3 als Standort angegeben wurde, werden mit dieser Abgleichsstrategie Entwicklermetadaten abgeglichen, die mit Zeile 3 verknüpft sind, sowie Metadaten, die mit Standorten verknüpft sind, die sich mit Zeile 3 überschneiden. Wenn beispielsweise Entwicklermetadaten mit Spalte B verknüpft sind, würde diese Abgleichsstrategie auch diesen Standort finden, da Spalte B Zeile 3 schneidet.