REST Resource: albums

Resource: Album

Representasi album di Google Foto. Album adalah penampung untuk item media. Jika telah dibagikan oleh aplikasi, album akan berisi properti shareInfo tambahan.

Representasi JSON 
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
Kolom
id

string

ID untuk album. Ini adalah ID persisten yang dapat digunakan di antara sesi untuk mengidentifikasi album ini.
title

string

Nama album yang ditampilkan kepada pengguna di akun Google Foto mereka. String ini tidak boleh lebih dari 500 karakter.
productUrl

string

[Output only] URL Google Foto untuk album. Pengguna harus login ke akun Google Foto miliknya untuk mengakses link ini.
isWriteable

boolean

[Output only] Benar jika Anda dapat membuat item media di album ini. Kolom ini didasarkan pada cakupan yang diberikan dan izin album. Jika cakupan diubah atau izin album diubah, kolom ini akan diperbarui.
shareInfo

object (ShareInfo)

[Khusus output] Informasi terkait album bersama. Kolom ini hanya diisi jika album adalah album bersama, developer membuat album, dan pengguna telah memberikan cakupan photoslibrary.sharing.
mediaItemsCount

string (int64 format)

[Khusus output] Jumlah item media dalam album.
coverPhotoBaseUrl

string

[Khusus output] URL ke byte foto sampul. URL ini tidak boleh digunakan apa adanya. Parameter harus ditambahkan ke URL ini sebelum digunakan. Lihat dokumentasi developer untuk mengetahui daftar lengkap parameter yang didukung. Misalnya, '=w2048-h1024' menetapkan dimensi foto sampul agar memiliki lebar 2.048 piksel dan tinggi 1.024 piksel.
coverPhotoMediaItemId

string

ID untuk item media yang terkait dengan foto sampul.

ShareInfo

Informasi tentang album yang dibagikan. Informasi ini hanya disertakan jika Anda membuat album, album tersebut dibagikan, dan Anda memiliki cakupan berbagi.

Representasi JSON 
{
  "sharedAlbumOptions": {
    object (SharedAlbumOptions)
  },
  "shareableUrl": string,
  "shareToken": string,
  "isJoined": boolean,
  "isOwned": boolean,
  "isJoinable": boolean
}
Kolom
sharedAlbumOptions

object (SharedAlbumOptions)

Opsi yang mengontrol apakah seseorang dapat menambahkan item media ke, atau mengomentari album bersama.
shareableUrl

string

Link ke album Google Foto bersama. Siapa pun yang memiliki link dapat melihat konten album, jadi link tersebut harus diperlakukan dengan hati-hati.

Parameter shareableUrl hanya ditampilkan jika album telah mengaktifkan berbagi link. Jika pengguna sudah bergabung ke album yang tidak dibagikan dengan link, mereka dapat menggunakan productUrl album untuk mengaksesnya.

shareableUrl akan menjadi tidak valid jika pemilik menonaktifkan berbagi link di aplikasi Google Foto, atau jika album tidak dibagikan.
shareToken

string

Token yang digunakan untuk bergabung, keluar, atau mengambil detail album bersama atas nama pengguna yang bukan pemiliknya.

shareToken akan menjadi tidak valid jika pemilik menonaktifkan berbagi link di aplikasi Google Foto, atau jika album tidak dibagikan.
isJoined

boolean

Benar jika pengguna bergabung ke album. Hal ini selalu berlaku untuk pemilik album.
isOwned

boolean

Benar jika pengguna memiliki album.
isJoinable

boolean

Benar jika album dapat diikuti oleh pengguna.

SharedAlbumOptions

Opsi yang mengontrol pembagian album.

Representasi JSON 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
Kolom
isCollaborative

boolean

Benar jika album bersama mengizinkan kolaborator (pengguna yang telah bergabung ke album) untuk menambahkan item media ke dalamnya. Nilai defaultnya adalah false (salah).
isCommentable

boolean

Benar jika album bersama mengizinkan kolaborator (pengguna yang telah bergabung ke album) untuk menambahkan komentar ke album. Nilai defaultnya adalah false (salah).

Metode

addEnrichment

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

batchAddMediaItems

 Menambahkan satu atau beberapa item media yang dibuat aplikasi di galeri Google Foto pengguna ke album yang dibuat aplikasi.

batchRemoveMediaItems

 Menghapus satu atau beberapa item media yang dibuat aplikasi dari album yang dibuat aplikasi yang ditentukan.

create

 Membuat album di galeri foto pengguna.

get

 Menampilkan album yang dibuat aplikasi berdasarkan albumId yang ditentukan.

list

 Mencantumkan semua album yang dibuat oleh aplikasi Anda.

patch

 Perbarui album yang dibuat aplikasi dengan id yang ditentukan.