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 möglicherweise einschränken, welche Daten ausgewählt werden. Für filter ist nur einer der folgenden Werte zulässig:
developerMetadataLookup

object (DeveloperMetadataLookup)

Es werden Daten ausgewählt, die mit den Entwicklermetadaten verknüpft sind, die 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, das mit allen angegebenen Feldern übereinstimmt. Wenn beispielsweise nur eine Metadaten-ID angegeben ist, wird die DeveloperMetadata mit dieser speziellen 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 damit 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)

Beschränkt 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, berücksichtigt diese Suche nur Entwicklermetadaten, 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 wenn metadataLocation als Speicherort angegeben ist, bei dem es sich nicht um einen Speicherort für die Tabelle handelt. Die Metadaten der Tabelle dürfen sich mit keinem anderen Speicherort der Entwicklermetadaten überschneiden. Dieses Feld darf auch nicht spezifiziert werden, wenn locationMatchingStrategy als EXACT angegeben wird.
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 bei dieser Suche der Standort abgeglichen wird. Wenn für dieses Feld GENAU angegeben ist, werden nur Entwicklermetadaten abgeglichen, die genau mit dem angegebenen Standort verknüpft sind. Wenn für dieses Feld INTERSECTING angegeben ist, werden die Entwicklermetadaten, die sich überschneidenden Standorten zugeordnet sind, ebenfalls abgeglichen. Wenn nicht angegeben, wird in diesem Feld der Standardwert INTERSECTING verwendet. Wenn dieses Feld angegeben ist, muss auch 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

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

enum (DeveloperMetadataVisibility)

Beschränkt die ausgewählten Entwicklermetadaten auf die Metadaten, die eine übereinstimmende DeveloperMetadata.visibility haben. Wenn nicht angegeben, 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 wäre, würde diese Abgleichsstrategie nur mit Entwicklermetadaten übereinstimmen, die auch in Zeile 3 verknüpft sind. Mit anderen Standorten verknüpfte Metadaten werden nicht berücksichtigt.
INTERSECTING_LOCATION Gibt an, dass ein bestimmter Standort sowohl mit diesem genauen Standort als auch mit allen sich überschneidenden Standorten übereinstimmen soll. Wenn beispielsweise Zeile 3 als Standort angegeben wird, würde diese Abgleichsstrategie den Entwicklermetadaten aus Zeile 3 sowie Metadaten zu Standorten entsprechen, die sich in Zeile 3 überschneiden. Wenn beispielsweise in Spalte B Entwicklermetadaten verknüpft wären, würde diese Abgleichsstrategie auch diesen Ort zuordnen, da sich Spalte B mit Zeile 3 überschneidet.