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 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 miliknya untuk mengakses link ini.
isWriteable

boolean

[Hanya output] Benar jika Anda dapat membuat item media dalam 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 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

[Khusus output] URL ke byte foto sampul. Hal 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 piksel dan tinggi 1024 piksel.
coverPhotoMediaItemId

string

ID untuk item media yang terkait dengan foto sampul.

ShareInfo

Informasi tentang album yang dibagikan. Informasi ini hanya disertakan jika Anda yang 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 yang dibagikan. Siapa pun yang memiliki link dapat melihat konten album, sehingga album tersebut harus ditangani dengan hati-hati.

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

shareableUrl menjadi tidak valid jika pemilik menonaktifkan berbagi link di aplikasi Google Foto, atau jika album dibatalkan pembagiannya.
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

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

boolean

Benar 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

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

boolean

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

Metode

addEnrichment

batchAddMediaItems

batchRemoveMediaItems

create

get

list

patch

 Perbarui album dengan id yang ditentukan.

share

unshare