REST Resource: spreadsheets.developerMetadata

Risorsa: DeveloperMetadata

Metadati dello sviluppatore associati a una località o a un oggetto in un foglio di lavoro. I metadati dello sviluppatore possono essere utilizzati per associare dati arbitrari a varie parti di un foglio di lavoro e rimarranno associati a queste posizioni man mano che si spostano e il foglio di lavoro viene modificato. Ad esempio, se i metadati dello sviluppatore sono associati alla riga 5 e successivamente viene inserita un'altra riga sopra la riga 5, i metadati originali rimarranno associati alla riga a cui erano associati per la prima volta (ora riga 6). Se l'oggetto associato viene eliminato, vengono eliminati anche i relativi metadati.

Rappresentazione JSON 
{   "metadataId": integer,   "metadataKey": string,   "metadataValue": string,   "location": {     object (DeveloperMetadataLocation)   },   "visibility": enum (DeveloperMetadataVisibility) }
Campi
metadataId

integer

L'ID univoco basato sul foglio di lavoro che identifica i metadati. Gli ID possono essere specificati al momento della creazione dei metadati, altrimenti ne verrà generato e assegnato uno in modo casuale. Il valore deve essere positivo.
metadataKey

string

La chiave dei metadati. In un foglio di lavoro possono essere presenti più metadati con la stessa chiave. I metadati dello sviluppatore devono sempre avere una chiave specificata.
metadataValue

string

Dati associati alla chiave dei metadati.
location

object (DeveloperMetadataLocation)

La posizione in cui sono associati i metadati.
visibility

enum (DeveloperMetadataVisibility)

La visibilità dei metadati. Per i metadati dello sviluppatore deve sempre essere specificata una visibilità.

DeveloperMetadataLocation

Una posizione in cui i metadati possono essere associati in un foglio di lavoro.

Rappresentazione JSON 
{   "locationType": enum (DeveloperMetadataLocationType),    // Union field location can be only one of the following:   "spreadsheet": boolean,   "sheetId": integer,   "dimensionRange": {     object (DimensionRange)   }   // End of list of possible types for union field location. }
Campi
locationType

enum (DeveloperMetadataLocationType)

Il tipo di località rappresentato da questo oggetto. Questo campo è di sola lettura.
Campo unione location. La posizione in cui sono associati i metadati. location può essere solo uno dei seguenti:
spreadsheet

boolean

True se i metadati sono associati a un intero foglio di lavoro.
sheetId

integer

L'ID del foglio quando i metadati sono associati a un intero foglio.
dimensionRange

object (DimensionRange)

Rappresenta la riga o la colonna quando i metadati sono associati a una dimensione. Il valore DimensionRange specificato deve rappresentare una singola riga o colonna; non può essere illimitato o occupare più righe o colonne.

DeveloperMetadataLocationType

Un'enumerazione dei tipi di posizioni a cui possono essere associati i metadati dello sviluppatore.

Enum
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED Valore predefinito.
ROW Metadati dello sviluppatore associati a un'intera dimensione di riga.
COLUMN Metadati dello sviluppatore associati a un'intera dimensione di colonna.
SHEET Metadati dello sviluppatore associati a un intero foglio.
SPREADSHEET Metadati dello sviluppatore associati all'intero foglio di lavoro.

DeveloperMetadataVisibility

Un'enumerazione delle possibili visibilità dei metadati.

Enum
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED Valore predefinito.
DOCUMENT I metadati visibili nel documento sono accessibili da qualsiasi progetto dello sviluppatore con accesso al documento.
PROJECT I metadati visibili a livello di progetto sono visibili e accessibili solo al progetto dello sviluppatore che li ha creati.

Metodi

get

 Restituisce i metadati dello sviluppatore con l'ID specificato.
Restituisce tutti i metadati dello sviluppatore corrispondenti al DataFilter specificato.