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.