Method: albums.addEnrichment

Ajoute un enrichissement à une position spécifiée dans un album créé par une application.

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 créé par l'application 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. L'enrichissement à ajouter.
albumPosition

object (AlbumPosition)

Obligatoire. Position dans l'album créé par l'application où l'enrichissement 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. Enricissement ajouté.

Champs d'application des autorisations

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

  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata

NewEnrichmentItem

Nouvel élément d'enrichissement à ajouter à un album créé par une application, 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. Élément à enrichir à l'album créé par l'application. 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 créé par l'application.
locationEnrichment

object (LocationEnrichment)

Lieu à ajouter à l'album créé par l'application.
mapEnrichment

object (MapEnrichment)

Carte à ajouter à l'album créé par l'application.

TextEnrichment

Enrichissement contenant du texte.

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

string

Texte de cet élément d'enrichissement.

LocationEnrichment

Un enrichissement contenant un seul établissement

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, montrant les emplacements de départ et de destination.

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 pour cet élément d'enrichissement.

EnrichmentItem

Élément d'enrichissement.

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

string

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