DataFilter

Filtro che descrive quali dati devono essere selezionati o restituiti da una richiesta. Per saperne di più, consulta Leggere, scrivere ed eseguire ricerche nei metadati.

Rappresentazione JSON
{

  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
}
Campi
Campo unione filter. I tipi di filtri che potrebbero limitare i dati selezionati. filter può essere solo uno dei seguenti tipi:
developerMetadataLookup

object (DeveloperMetadataLookup)

Seleziona i dati associati ai metadati dello sviluppatore che corrispondono ai criteri descritti in questo DeveloperMetadataLookup.

a1Range

string

Seleziona i dati che corrispondono all'intervallo A1 specificato.

gridRange

object (GridRange)

Seleziona i dati che corrispondono all'intervallo descritto da 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 quell'ID univoco specifico. Se viene specificata una chiave di metadati, vengono presi in considerazione tutti i metadati dello sviluppatore con quella chiave. Se vengono specificati una chiave, un tipo di visibilità e una posizione, vengono presi in considerazione tutti i metadati dello sviluppatore con quella chiave e visibilità associati a una posizione di quel tipo. In generale, vengono selezionati tutti i DeveloperMetadata 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 a località del tipo specificato. Ad esempio, quando questo campo è specificato come ROW, la 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 quando locationMatchingStrategy è specificato come INTERSECTING o quando metadataLocation è specificato come posizione non di un foglio di lavoro. I metadati del foglio di lavoro non possono intersecare altre posizioni dei metadati dello sviluppatore. Questo campo deve essere lasciato non specificato anche quando locationMatchingStrategy è specificato come EXACT.

metadataLocation

object (DeveloperMetadataLocation)

Limita i metadati dello sviluppatore selezionati alle voci associate alla posizione specificata. Questo campo corrisponde a località esatte o a tutte le località che si intersecano in base al locationMatchingStrategy specificato.

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Determina in che modo questa ricerca corrisponde alla posizione. Se questo campo è specificato come EXACT, vengono trovati solo i metadati dello sviluppatore associati alla posizione esatta specificata. Se questo campo è specificato come INTERSECTING, vengono trovati anche i metadati dello sviluppatore associati alle posizioni di intersezione. Se non specificato, questo campo assume il valore predefinito INTERSECTING. Se questo campo è specificato, deve essere specificato anche un metadataLocation.

metadataId

integer

Limita i metadati dello sviluppatore selezionato a quelli che hanno un DeveloperMetadata.metadata_id corrispondente.

metadataKey

string

Limita i metadati dello sviluppatore selezionato a quelli che hanno un DeveloperMetadata.metadata_key corrispondente.

metadataValue

string

Limita i metadati dello sviluppatore selezionato a quelli che hanno un DeveloperMetadata.metadata_value corrispondente.

visibility

enum (DeveloperMetadataVisibility)

Limita i metadati dello sviluppatore selezionato a quelli che hanno un DeveloperMetadata.visibility corrispondente. Se non vengono specificati, vengono presi in considerazione tutti i metadati dello sviluppatore visibili al progetto richiedente.

DeveloperMetadataLocationMatchingStrategy

Un'enumerazione delle strategie per la corrispondenza 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 3 è stata specificata come posizione, questa strategia di corrispondenza corrisponderà solo ai metadati dello sviluppatore associati anche alla riga 3. I metadati associati ad altre località non verranno presi in considerazione.
INTERSECTING_LOCATION Indica che una località specificata deve corrispondere esattamente a quella località, nonché a qualsiasi località che la interseca. Ad esempio, se la riga 3 è stata specificata come posizione, questa strategia di corrispondenza corrisponderà ai metadati dello sviluppatore associati alla riga 3, nonché ai metadati associati alle posizioni che intersecano la riga 3. Se, ad esempio, nella colonna B sono presenti metadati dello sviluppatore associati, questa strategia di corrispondenza corrisponderà anche a questa posizione perché la colonna B interseca la riga 3.