- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- NewEnrichmentItem
- TextEnrichment
- LocationEnrichment
- Ubicación
- LatLng
- MapEnrichment
- EnrichmentItem
- Pruébalo
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 |
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 ( |
Campos | |
---|---|
newEnrichmentItem |
Obligatorio. El enriquecimiento que se agregará. |
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 ( |
Campos | |
---|---|
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 |
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 |
Texto que se agregará al álbum. |
locationEnrichment |
La ubicación que se agregará al álbum. |
mapEnrichment |
El mapa se agregará al álbum. |
TextEnrichment
Es un enriquecimiento que contiene texto.
Representación JSON |
---|
{ "text": string } |
Campos | |
---|---|
text |
Texto de este elemento de enriquecimiento. |
LocationEnrichment
Un enriquecimiento que contiene una sola ubicación.
Representación JSON |
---|
{
"location": {
object ( |
Campos | |
---|---|
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 ( |
Campos | |
---|---|
locationName |
Es el nombre de la ubicación que se mostrará. |
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 |
La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0]. |
longitude |
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 ( |
Campos | |
---|---|
origin |
Ubicación de origen de este artículo de enriquecimiento. |
destination |
Ubicación de destino de este elemento de enriquecimiento. |
EnrichmentItem
Un elemento de enriquecimiento.
Representación JSON |
---|
{ "id": string } |
Campos | |
---|---|
id |
Es el identificador del elemento de enriquecimiento. |