REST Resource: albums

Aset: Album

Representasi album di Google Foto. Album adalah penampung untuk item media. Jika album telah dibagikan oleh aplikasi, album tersebut 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 pengenal tetap 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

[Hanya output] URL Google Foto untuk album. Pengguna harus login ke akun Google Foto mereka untuk mengakses link ini.
isWriteable

boolean

[Hanya output] 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)

[Hanya output] Informasi yang terkait dengan album bersama. Kolom ini hanya diisi jika album tersebut merupakan album bersama, developer membuat album tersebut, dan pengguna telah memberikan cakupan photoslibrary.sharing.
mediaItemsCount

string (int64 format)

[Hanya output] Jumlah item media dalam album.
coverPhotoBaseUrl

string

[Hanya output] URL ke byte foto sampul. Parameter ini tidak boleh digunakan sebagaimana 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 2048 px dan tinggi 1024 px.
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, 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, sehingga harus diperlakukan dengan hati-hati.

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

shareableUrl menjadi tidak valid jika pemilik menonaktifkan berbagi link di aplikasi Google Foto, atau jika album tersebut dibatalkan berbaginya.
shareToken

string

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

shareToken menjadi tidak valid jika pemilik menonaktifkan berbagi link di aplikasi Google Foto, atau jika album tersebut dibatalkan berbaginya.
isJoined

boolean

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

boolean

True jika pengguna memiliki album.
isJoinable

boolean

True jika album dapat digabungkan oleh pengguna.

SharedAlbumOptions

Opsi yang mengontrol pembagian album.

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

boolean

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

boolean

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

Metode

addEnrichment

 Menambahkan pengayaan pada posisi tertentu dalam album yang ditentukan.

batchAddMediaItems

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

batchRemoveMediaItems

 Menghapus satu atau beberapa item media dari album tertentu.

create

 Membuat album di galeri foto Google Foto pengguna.

get

 Menampilkan album berdasarkan albumId yang ditentukan.

list

 Mencantumkan semua album yang ditampilkan kepada pengguna di tab Album di aplikasi Google Foto.

patch

 Memperbarui album dengan id yang ditentukan.

share

 Menandai album sebagai dibagikan dan dapat diakses oleh pengguna lain.

unshare

 Menandai album yang sebelumnya dibagikan sebagai pribadi.