Method: albums.addEnrichment

Agrega un enriquecimiento en una posición determinada 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 donde 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. Enriquecimiento que se agregó.

Permisos de autorización

Se necesita uno de los siguientes alcances 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 complemento que se agregará a un álbum, usado por 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. Enriquecimiento que se agregará 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)

Ubicación que se agregará al álbum.
mapEnrichment

object (MapEnrichment)

Mapa que se agregará al álbum.

TextEnrichment

Es un enriquecimiento que contiene texto.

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

string

Texto del elemento de actualización.

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 actualización.

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 dobles para representar la latitud en grados y la longitud en grados. 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 contiene un mapa que muestra las ubicaciones de origen y destino.

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

object (Location)

Ubicación de origen de este elemento de actualización.
destination

object (Location)

Ubicación de destino de este elemento enriquecido.

EnrichmentItem

Es un elemento de enriquecimiento.

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

string

Es el identificador del elemento de actualización.