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 determinato ID univoco. Se viene specificata una chiave dei metadati, vengono presi in considerazione tutti i metadati dello sviluppatore con quella chiave. Se vengono specificati una chiave, una visibilità e un tipo di località, vengono presi in considerazione tutti i metadati dello sviluppatore con quella chiave e visibilità associati a una località di quel tipo. In generale, vengono selezionati tutti i campi DeveloperMetadata corrispondenti 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 considerati tutti i tipi di località. Questo campo non può essere specificato come SPREADSHEET se locationMatchingStrategy è specificato come INTERSECTING o se metadataLocation è specificato come posizione non del foglio di lavoro: i metadati del foglio di lavoro non possono intersecare nessun'altra posizione dei 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 località esatte o a tutte le località che si intersecano in base a locationMatchingStrategy specificato.

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Determina in che modo questa ricerca corrisponde alla località. Se questo campo è specificato come EXACT, vengono trovati corrispondenti solo i metadati dello sviluppatore associati alla posizione esatta specificata. Se per questo campo viene specificato INTERSECTING, vengono trovati corrispondenze anche per i metadati dello sviluppatore associati alle posizioni di intersezione. Se non viene 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 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 terza riga fosse specificata come località, questa strategia di corrispondenza corrisponderebbe solo ai metadati dello sviluppatore associati anche alla terza riga. 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, fossero stati associati metadati dello sviluppatore alla colonna B, questa strategia di corrispondenza corrisponderebbe anche a quella posizione perché la colonna B interseca la terza riga.