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 und 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 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 dadurch alle DeveloperMetadata ausgewählt, die mit der Schnittmenge aller angegebenen Felder übereinstimmen. Es kann jedes 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)

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, werden bei dieser Suche nur Entwicklermetadaten berücksichtigt, 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 der locationMatchingStrategy als INTERSECTING oder der metadataLocation als nicht tabellenbasierter Speicherort angegeben ist. Tabellenmetadaten dürfen sich nicht mit anderen Speicherorten für Entwicklermetadaten überschneiden. Dieses Feld muss auch leer bleiben, wenn locationMatchingStrategy als GENAU angegeben ist.

metadataLocation

object (DeveloperMetadataLocation)

Die ausgewählten Entwicklermetadaten werden auf die Einträge beschränkt, 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 „INTERSECTING“ (Überschneidend) angegeben ist, werden auch Entwicklermetadaten abgeglichen, die mit sich überschneidenden Standorten verknüpft sind. Wenn Sie dieses Feld leer lassen, wird standardmäßig INTERSECTING verwendet. Wenn dieses Feld angegeben ist, muss auch metadataLocation angegeben werden.

metadataId

integer

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

metadataKey

string

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

metadataValue

string

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

visibility

enum (DeveloperMetadataVisibility)

Die ausgewählten Entwicklermetadaten werden auf solche mit übereinstimmender DeveloperMetadata.visibility beschränkt. 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 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 abgeglichen werden soll. 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.