Method: albums.addEnrichment

Fügen Sie einem in einer App erstellten Album an einer bestimmten Position eine Datenanreicherung 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. Die Kennung des von der App erstellten 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 Datenanreicherung.
albumPosition

object (AlbumPosition)

Erforderlich. Die Position im von der App erstellten Album, an der die Daten angereichert werden sollen.

Antworttext

Das erstellte Datensatzelement.

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

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

object (EnrichmentItem)

Nur Ausgabe. Hinzugefügte Datenanreicherung.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

NewEnrichmentItem

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

object (TextEnrichment)

Text, der dem von der App erstellten Album hinzugefügt werden soll.
locationEnrichment

object (LocationEnrichment)

Der Ort, der dem von der App erstellten Album hinzugefügt werden soll.
mapEnrichment

object (MapEnrichment)

Karte, die dem von der App erstellten Album hinzugefügt werden soll.

TextEnrichment

Eine Datenanreicherung, die Text enthält.

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

string

Text für dieses Datensatzelement.

LocationEnrichment

Eine Datenanreicherung mit einem einzelnen Standort.

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

object (Location)

Ort für dieses Datensatz-Enrichment.

Standort

Stellt einen physischen Standort dar.

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

string

Der Name des angezeigten Standorts.
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 von Double-Werten ausgedrückt, die für den Breitengrad und den Längengrad stehen. Sofern nicht anders angegeben, muss es dem World Geodetic System 1984 (WGS 84) 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 Aufbereitung mit einer Karte, auf der Start- und Zielorte zu sehen sind.

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

object (Location)

Ursprungsort für dieses Datensatz-Enrichment.
destination

object (Location)

Zielstandort für diesen Datensatz.

EnrichmentItem

Ein Datensatz mit Datenanreicherung.

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

string

Kennung des Datensatzes für die Datenergänzung.