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 de 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. Enrichissement 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. 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.

Enrichissement du texte

Un contenu enrichissant contenant du texte.

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

string

Texte de cet élément d'enrichissement.

Enrichissement de la localisation

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 établissement 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].

Enrichissement de carte

Un élément enrichissant 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.

Élément d'enrichissement

Élément d'enrichissement.

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

string

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