Method: albums.addEnrichment

Fügt eine Anreicherung an einer bestimmten Position in einem definierten Album 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. Kennung des Albums, dem die Daten angehängt werden sollen.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (NewEnrichmentItem)

Erforderlich. Die hinzuzufügende Anreicherung.

albumPosition

object (AlbumPosition)

Erforderlich. Die Position im Album, an die 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 wurde hinzugefügt.

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
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata

NewEnrichmentItem

Ein neues Anreicherungselement, das vom albums.addEnrichment-Aufruf verwendet wird und zu 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. Anreicherung, die dem Album hinzugefügt werden soll. Das kann ein Text, ein Ort oder eine Karte sein. Für enrichment ist nur einer der folgenden Werte zulässig:
textEnrichment

object (TextEnrichment)

Text, der zum 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 mit einem einzelnen Standort.

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

object (Location)

Standort für dieses Anreicherungselement.

Standort

Stellt einen physischen Standort dar.

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

string

Name des Standorts, der angezeigt werden soll.

latlng

object (LatLng)

Position des Standorts auf der Karte.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar aus Werten vom Typ „Double“ (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, die eine Karte mit Start- und Zielorten enthält.

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

object (Location)

Ursprungsort für dieses Datensatz-Enrichment-Element.

destination

object (Location)

Zielort für dieses erweiterte Element.

EnrichmentItem

Ein Erweiterungselement.

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

string

ID des Anreicherungselements.