Method: albums.addEnrichment

Agrega un enriquecimiento en una posición especificada de un álbum definido.

Solicitud HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:addEnrichment

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
albumId

string

Obligatorio. Es el identificador del álbum en el que se agregará el enriquecimiento.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
Campos
newEnrichmentItem

object (NewEnrichmentItem)

Obligatorio. El enriquecimiento que se agregará.

albumPosition

object (AlbumPosition)

Obligatorio. Es la posición en el álbum en la que se insertará el enriquecimiento.

Cuerpo de la respuesta

El elemento de enriquecimiento que se crea.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
Campos
enrichmentItem

object (EnrichmentItem)

Solo salida. Se agregó el enriquecimiento.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

NewEnrichmentItem

Un nuevo elemento de enriquecimiento que se agregará a un álbum, que usará la llamada a albums.addEnrichment.

Representación JSON
{

  // Union field enrichment can be only one of the following:
  "textEnrichment": {
    object (TextEnrichment)
  },
  "locationEnrichment": {
    object (LocationEnrichment)
  },
  "mapEnrichment": {
    object (MapEnrichment)
  }
  // End of list of possible types for union field enrichment.
}
Campos
Campo de unión enrichment. Se agregará un enriquecimiento al álbum. Podría ser un texto, una ubicación o un mapa. Las direcciones (enrichment) solo pueden ser una de las siguientes opciones:
textEnrichment

object (TextEnrichment)

Texto que se agregará al álbum.

locationEnrichment

object (LocationEnrichment)

La ubicación que se agregará al álbum.

mapEnrichment

object (MapEnrichment)

El mapa se agregará al álbum.

TextEnrichment

Es un enriquecimiento que contiene texto.

Representación JSON
{
  "text": string
}
Campos
text

string

Texto de este elemento de enriquecimiento.

LocationEnrichment

Un enriquecimiento que contiene una sola ubicación.

Representación JSON
{
  "location": {
    object (Location)
  }
}
Campos
location

object (Location)

Es la ubicación de este elemento de enriquecimiento.

Ubicación

Representa una ubicación física.

Representación JSON
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
Campos
locationName

string

Es el nombre de la ubicación que se mostrará.

latlng

object (LatLng)

Es la posición de la ubicación en el mapa.

LatLng

Es un objeto que representa un par de valores de latitud y longitud. Esto se expresa como un par de números de punto flotante de doble precisión que representan los grados de latitud y longitud. A menos que se especifique lo contrario, este objeto debe cumplir con el estándar WGS84. Los valores deben pertenecer a rangos normalizados.

Representación JSON
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].

longitude

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

MapEnrichment

Es un enriquecimiento que incluye un mapa en el que se muestran las ubicaciones de origen y de destino.

Representación JSON
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
Campos
origin

object (Location)

Ubicación de origen de este artículo de enriquecimiento.

destination

object (Location)

Ubicación de destino de este elemento de enriquecimiento.

EnrichmentItem

Un elemento de enriquecimiento.

Representación JSON
{
  "id": string
}
Campos
id

string

Es el identificador del elemento de enriquecimiento.