REST Resource: spreadsheets.developerMetadata

Recurso: DeveloperMetadata

Metadatos del desarrollador asociados con una ubicación o un objeto en una hoja de cálculo Los metadatos del programador se pueden usar para asociar datos arbitrarios con distintas partes de una hoja de cálculo y permanecerán asociados en esas ubicaciones a medida que se muevan y se edite la hoja de cálculo. Por ejemplo, si los metadatos del desarrollador están asociados con la fila 5 y posteriormente se inserta otra fila encima de la fila 5, esos metadatos originales seguirán estando asociados con la fila con la que se asoció primero (lo que ahora es la fila 6). Si se borra el objeto asociado, también se borran sus metadatos.

Representación JSON 
{
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "location": {
    object (DeveloperMetadataLocation)
  },
  "visibility": enum (DeveloperMetadataVisibility)
}
Campos
metadataId

integer

El ID único dentro de la hoja de cálculo que identifica los metadatos. Se pueden especificar IDs cuando se crean los metadatos; de lo contrario, se generará uno y se asignará uno de forma aleatoria. Debe ser positivo.
metadataKey

string

La clave de metadatos. Puede haber varios metadatos en una hoja de cálculo con la misma clave. Los metadatos del desarrollador siempre deben tener una clave especificada.
metadataValue

string

Los datos asociados con la clave de los metadatos.
location

object (DeveloperMetadataLocation)

La ubicación donde se asocian los metadatos.
visibility

enum (DeveloperMetadataVisibility)

La visibilidad de los metadatos. Los metadatos del desarrollador siempre deben tener una visibilidad especificada.

DeveloperMetadataLocation

Una ubicación donde los metadatos pueden estar asociados en una hoja de cálculo.

Representación 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.
}
Campos
locationType

enum (DeveloperMetadataLocationType)

El tipo de ubicación que representa este objeto. Este campo es de solo lectura.
Campo de unión location. La ubicación donde se asocian los metadatos. Las direcciones (location) solo pueden ser una de las siguientes opciones:
spreadsheet

boolean

Es verdadero cuando los metadatos están asociados con toda la hoja de cálculo.
sheetId

integer

El ID de la hoja cuando los metadatos se asocian con una hoja completa.
dimensionRange

object (DimensionRange)

Representa la fila o columna cuando los metadatos se asocian con una dimensión. El DimensionRange especificado debe representar una sola fila o columna. no puede ser delimitado ni abarcar varias filas o columnas.

DeveloperMetadataLocationType

Una enumeración de los tipos de ubicaciones en las que se pueden asociar los metadatos del desarrollador.

Enumeraciones
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED Valor predeterminado
ROW Metadatos del desarrollador asociados con una dimensión de fila completa.
COLUMN Metadatos del desarrollador asociados en una dimensión de columna completa.
SHEET Metadatos del desarrollador asociados en toda una hoja
SPREADSHEET Metadatos del desarrollador asociados en toda la hoja de cálculo

DeveloperMetadataVisibility

Una enumeración de las posibles visibilidades de los metadatos

Enumeraciones
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED Valor predeterminado
DOCUMENT Se puede acceder a los metadatos visibles en el documento desde cualquier proyecto de desarrollador con acceso al documento.
PROJECT Solo el proyecto de desarrollador que creó los metadatos puede ver y acceder a los metadatos visibles en el proyecto.

Métodos

get

 Muestra los metadatos del desarrollador con el ID especificado.
Muestra todos los metadatos del desarrollador que coincidan con el DataFilter especificado.