Method: albums.addEnrichment

Ajoute un élément enrichi à une position spécifiée dans un album défini.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
albumId

string

Obligatoire. Identifiant de l'album dans lequel l'enrichissement doit être ajouté.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
Champs
newEnrichmentItem

object (NewEnrichmentItem)

Obligatoire. Enrichissement à ajouter.
albumPosition

object (AlbumPosition)

Obligatoire. Position dans l'album où le contenu enrichi doit être inséré.

Corps de la réponse

Élément d'enrichissement créé.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
Champs
enrichmentItem

object (EnrichmentItem)

Uniquement en sortie. Ajout de fonctions d'enrichissement.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

NewEnrichmentItem

Nouvel élément d'enrichissement à ajouter à un album, utilisé par l'appel albums.addEnrichment.

Représentation 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.
}
Champs
Champ d'union enrichment. Enrichissement à ajouter à l'album. Il peut s'agir d'un texte, d'un lieu ou d'une carte. enrichment ne peut être qu'un des éléments suivants :
textEnrichment

object (TextEnrichment)

Texte à ajouter à l'album.
locationEnrichment

object (LocationEnrichment)

Lieu à ajouter à l'album
mapEnrichment

object (MapEnrichment)

Carte à ajouter à l'album.

TextEnrichment

Enrichissement contenant du texte.

Représentation JSON 
{
  "text": string
}
Champs
text

string

Texte de cet élément d'enrichissement.

LocationEnrichment

Enrichissement contenant un seul lieu.

Représentation JSON 
{
  "location": {
    object (Location)
  }
}
Champs
location

object (Location)

Emplacement de cet élément d'enrichissement.

Emplacement

Représente un emplacement physique.

Représentation JSON 
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
Champs
locationName

string

Nom de l'établissement à afficher.
latlng

object (LatLng)

Position du lieu sur la carte.

LatLng

Objet représentant une paire latitude/longitude. Cette valeur est exprimée par une paire de doubles représentant les degrés de latitude et de longitude. Sauf indication contraire, cet objet doit être conforme à la norme WGS84. Les valeurs doivent se situer dans les limites normalisées.

Représentation JSON 
{
  "latitude": number,
  "longitude": number
}
Champs
latitude

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].
longitude

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

MapEnrichment

Enrichissement contenant une carte, indiquant les points de départ et d'arrivée.

Représentation JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
Champs
origin

object (Location)

Emplacement d'origine de cet élément d'enrichissement.
destination

object (Location)

Emplacement de destination de cet élément enrichi.

EnrichmentItem

Élément d'enrichissement.

Représentation JSON 
{
  "id": string
}
Champs
id

string

Identifiant de l'élément d'enrichissement.