DataFilter

Filtro che descrive quali dati devono essere selezionati o restituiti da una richiesta.

Rappresentazione JSON
{

  // 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.
}
Campi
Campo unione filter. I tipi di filtri che possono limitare i dati selezionati. filter può essere solo uno dei seguenti:
developerMetadataLookup

object (DeveloperMetadataLookup)

Seleziona i dati associati ai metadati dello sviluppatore corrispondenti ai criteri descritti da questo DeveloperMetadataLookup.

a1Range

string

Seleziona i dati corrispondenti all'intervallo A1 specificato.

gridRange

object (GridRange)

Seleziona i dati corrispondenti all'intervallo descritto dall'espressione GridRange.

DeveloperMetadataLookup

Seleziona DeveloperMetadata che corrisponde a tutti i campi specificati. Ad esempio, se viene specificato solo un ID metadati, viene considerato il DeveloperMetadata con quel particolare ID univoco. Se viene specificata una chiave dei metadati, vengono presi in considerazione tutti i metadati dello sviluppatore con quella chiave. Se sono specificati tutti una chiave, una visibilità e un tipo di posizione, vengono considerati tutti i metadati dello sviluppatore con quella chiave e la visibilità associati a una posizione di quel tipo. In generale, vengono selezionati tutti i metadati Developer che corrispondono all'intersezione di tutti i campi specificati. è possibile specificare qualsiasi campo o combinazione di campi.

Rappresentazione JSON
{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}
Campi
locationType

enum (DeveloperMetadataLocationType)

Limita i metadati dello sviluppatore selezionati alle voci associate alle località del tipo specificato. Ad esempio, quando questo campo è specificato come ROW, questa ricerca prende in considerazione solo i metadati dello sviluppatore associati alle righe. Se il campo non viene specificato, vengono presi in considerazione tutti i tipi di località. Questo campo non può essere specificato come SPREADSHEET se locationMatchingStrategy è specificato come INTERSECTING o se metadataLocation è una posizione non in foglio di lavoro: i metadati del foglio di lavoro non possono intersecarsi con nessun'altra posizione di metadati dello sviluppatore. Anche questo campo deve essere lasciato non specificato quando locationMatchingStrategy è specificato come ESATTO.

metadataLocation

object (DeveloperMetadataLocation)

Limita i metadati dello sviluppatore selezionati alle voci associate alla località specificata. Questo campo corrisponde a posizioni esatte o a tutte le località che si intersecano secondo il valore locationMatchingStrategy specificato.

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Determina in che modo questa ricerca corrisponde alla località. Se questo campo è specificato come ESATTO, vengono trovati corrispondenti solo i metadati dello sviluppatore associati alla posizione esatta specificata. Se questo campo viene specificato su INTERSECTING, verranno trovate corrispondenze anche per i metadati dello sviluppatore associati alle località che si intersecano. Se non specificato, questo campo assume un valore predefinito di INTERSECTING. Se questo campo è specificato, è necessario specificare anche un metadataLocation.

metadataId

integer

Limita i metadati dello sviluppatore selezionati a quelli con un DeveloperMetadata.metadata_id corrispondente.

metadataKey

string

Limita i metadati dello sviluppatore selezionati a quelli con un valore DeveloperMetadata.metadata_key corrispondente.

metadataValue

string

Limita i metadati dello sviluppatore selezionati a quelli con un DeveloperMetadata.metadata_value corrispondente.

visibility

enum (DeveloperMetadataVisibility)

Limita i metadati dello sviluppatore selezionati a quelli con un DeveloperMetadata.visibility corrispondente. Se non viene specificato, vengono presi in considerazione tutti i metadati dello sviluppatore visibili al progetto che effettua la richiesta.

DeveloperMetadataLocationMatchingStrategy

Un'enumerazione di strategie per l'associazione delle posizioni dei metadati dello sviluppatore.

Enum
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED Valore predefinito. Questo valore non deve essere utilizzato.
EXACT_LOCATION Indica che una posizione specificata deve corrispondere esattamente. Ad esempio, se la riga tre fosse specificata come località, questa strategia di corrispondenza corrisponderà solo ai metadati dello sviluppatore associati alla riga tre. I metadati associati ad altre località non verranno presi in considerazione.
INTERSECTING_LOCATION Indica che una località specificata deve corrispondere a quella esatta, nonché a eventuali località intersecate. Ad esempio, se la terza riga fosse specificata come posizione, questa strategia di corrispondenza assocerebbe i metadati dello sviluppatore associati alla terza riga, nonché i metadati associati alle posizioni che intersecano la terza riga. Se, ad esempio, esistono metadati dello sviluppatore associati alla colonna B, questa strategia di corrispondenza corrisponderà anche a quella località perché la colonna B interseca la riga tre.