Method: albums.addEnrichment

Menambahkan pengayaan pada posisi yang ditentukan di album yang dibuat aplikasi.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
albumId

string

Wajib. ID album yang dibuat aplikasi tempat pengayaan akan ditambahkan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
Kolom
newEnrichmentItem

object (NewEnrichmentItem)

Wajib. Pengayaan yang akan ditambahkan.
albumPosition

object (AlbumPosition)

Wajib. Posisi di album yang dibuat aplikasi tempat pengayaan akan disisipkan.

Isi respons

Item pengayaan yang dibuat.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
Kolom
enrichmentItem

object (EnrichmentItem)

Hanya output. Pengayaan yang ditambahkan.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

NewEnrichmentItem

Item pengayaan baru yang akan ditambahkan ke album yang dibuat aplikasi, yang digunakan oleh panggilan albums.addEnrichment.

Representasi 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.
}
Kolom
Kolom union enrichment. Pengayaan yang akan ditambahkan ke album yang dibuat aplikasi. Ini dapat berupa teks, lokasi, atau peta. enrichment hanya dapat berupa salah satu dari berikut:
textEnrichment

object (TextEnrichment)

Teks yang akan ditambahkan ke album yang dibuat aplikasi.
locationEnrichment

object (LocationEnrichment)

Lokasi yang akan ditambahkan ke album yang dibuat aplikasi.
mapEnrichment

object (MapEnrichment)

Peta yang akan ditambahkan ke album yang dibuat aplikasi.

TextEnrichment

Pengayaan yang berisi teks.

Representasi JSON 
{
  "text": string
}
Kolom
text

string

Teks untuk item pengayaan ini.

LocationEnrichment

Pengayaan yang berisi satu lokasi.

Representasi JSON 
{
  "location": {
    object (Location)
  }
}
Kolom
location

object (Location)

Lokasi untuk item pengayaan ini.

Lokasi

Merepresentasikan lokasi fisik.

Representasi JSON 
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
Kolom
locationName

string

Nama lokasi yang akan ditampilkan.
latlng

object (LatLng)

Posisi lokasi di peta.

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Ini dinyatakan sebagai pasangan nilai ganda untuk mewakili derajat lintang dan derajat bujur. Kecuali ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

MapEnrichment

Pengayaan yang berisi peta, yang menampilkan lokasi asal dan tujuan.

Representasi JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
Kolom
origin

object (Location)

Lokasi asal untuk item pengayaan ini.
destination

object (Location)

Lokasi tujuan untuk item pengayaan ini.

EnrichmentItem

Item pengayaan.

Representasi JSON 
{
  "id": string
}
Kolom
id

string

ID item pengayaan.