Method: albums.addEnrichment

Fügt in einem definierten Album an einer bestimmten Position eine Anreicherung hinzu.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
albumId

string

Erforderlich. ID des Albums, dem die Anreicherung hinzugefügt werden soll.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
Felder
newEnrichmentItem

object (NewEnrichmentItem)

Erforderlich. Die Anreicherung, die hinzugefügt werden soll.

albumPosition

object (AlbumPosition)

Erforderlich. Die Position im Album, an der die Anreicherung eingefügt werden soll.

Antworttext

Das erstellte Anreicherungselement.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
Felder
enrichmentItem

object (EnrichmentItem)

Nur Ausgabe Anreicherung, die hinzugefügt wurde.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

NewEnrichmentItem

Ein neues Anreicherungselement, das vom albums.addEnrichment-Aufruf verwendet wird und einem Album hinzugefügt wird.

JSON-Darstellung
{

  // 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.
}
Felder
Union-Feld enrichment. Bereich, der dem Album hinzugefügt werden soll. Dies kann entweder ein Text, ein Standort oder eine Karte sein. Für enrichment ist nur einer der folgenden Werte zulässig:
textEnrichment

object (TextEnrichment)

Text, der dem Album hinzugefügt werden soll.

locationEnrichment

object (LocationEnrichment)

Ort, der dem Album hinzugefügt werden soll.

mapEnrichment

object (MapEnrichment)

Karte, die dem Album hinzugefügt werden soll.

TextEnrichment

Eine Anreicherung mit Text.

JSON-Darstellung
{
  "text": string
}
Felder
text

string

Text für dieses Anreicherungselement.

LocationEnrichment

Eine Anreicherung, die einen einzelnen Ort enthält.

JSON-Darstellung
{
  "location": {
    object (Location)
  }
}
Felder
location

object (Location)

Ort für dieses Anreicherungselement.

Standort

Stellt einen physischen Standort dar.

JSON-Darstellung
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
Felder
locationName

string

Name des anzuzeigenden Standorts.

latlng

object (LatLng)

Position des Ortes auf der Karte.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Dies wird als Paar von Double-Werten (Breiten- und Längengrad) ausgedrückt. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

JSON-Darstellung
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.

longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

MapEnrichment

Eine Anreicherung mit einer Karte mit Start- und Zielorten.

JSON-Darstellung
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
Felder
origin

object (Location)

Ursprungsort dieses Anreicherungselements.

destination

object (Location)

Zielort für dieses erweiterte Element.

EnrichmentItem

Ein Erweiterungselement.

JSON-Darstellung
{
  "id": string
}
Felder
id

string

ID des Anreicherungselements.