Method: albums.addEnrichment

Ajoute un élément enrichissant à 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 auquel 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 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
  • 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. Élément à 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.

Lieu

Représente un emplacement physique.

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

string

Nom de l'emplacement à afficher.
latlng

object (LatLng)

Position du lieu sur la carte.

LatLng

Objet représentant une paire latitude/longitude. Elle 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 lieux de départ et de destination.

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

object (Location)

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

object (Location)

Emplacement de destination de cet élément enrichissant.

EnrichmentItem

Élément d'enrichissement.

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

string

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