REST Resource: albums

Kaynak: Albüm

Google Fotoğraflar'daki bir albümün temsili. Albümler, medya öğelerinin kapsayıcısıdır. Uygulama tarafından paylaşılan albümlerde ek bir shareInfo mülkü bulunur.

JSON gösterimi
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
Alanlar
id

string

Albümün tanımlayıcısıdır. Bu, albümü tanımlamak için oturumlar arasında kullanılabilen kalıcı bir tanımlayıcıdır.

title

string

Kullanıcıya Google Fotoğraflar hesabında gösterilen albümün adı. Bu dize en fazla 500 karakter uzunluğunda olmalıdır.

productUrl

string

[Yalnızca çıkış] Albümün Google Fotoğraflar URL'si. Kullanıcının bu bağlantıya erişmek için Google Fotoğraflar hesabında oturum açmış olması gerekir.

isWriteable

boolean

[Yalnızca çıkış] Bu albümde medya öğeleri oluşturabiliyorsanız doğru değerini döndürür. Bu alan, albümün izinlerine ve verilen kapsamlara bağlıdır. Kapsamlar veya albümün izinleri değişirse bu alan güncellenir.

shareInfo

object (ShareInfo)

[Yalnızca çıkış] Paylaşılan albümlerle ilgili bilgiler. Bu alan yalnızca albüm paylaşılan bir albümse, geliştirici albümü oluşturduysa ve kullanıcı photoslibrary.sharing kapsamını verdiyse doldurulur.

mediaItemsCount

string (int64 format)

[Yalnızca çıkış] Albümdeki medya öğelerinin sayısı.

coverPhotoBaseUrl

string

[Yalnızca çıkış] Kapak fotoğrafının baytlarının URL'si. Bu URL olduğu gibi kullanılmamalıdır. Parametreler, kullanılmadan önce bu URL'ye eklenmelidir. Desteklenen parametrelerin tam listesi için geliştirici belgelerine bakın. Örneğin, '=w2048-h1024', kapak fotoğrafının boyutlarını 2048 piksel genişlik ve 1024 piksel yükseklik olacak şekilde ayarlar.

coverPhotoMediaItemId

string

Kapak fotoğrafıyla ilişkili medya öğesinin tanımlayıcısı.

ShareInfo

Paylaşılan albümlerle ilgili bilgiler. Bu bilgiler yalnızca albümü siz oluşturduysanız, albüm paylaşılıyorsa ve paylaşım kapsamınız varsa dahil edilir.

JSON gösterimi
{
  "sharedAlbumOptions": {
    object (SharedAlbumOptions)
  },
  "shareableUrl": string,
  "shareToken": string,
  "isJoined": boolean,
  "isOwned": boolean,
  "isJoinable": boolean
}
Alanlar
sharedAlbumOptions

object (SharedAlbumOptions)

Kullanıcıların paylaşılan bir albüme medya öğesi ekleyip ekleyemeyeceğini veya albüme yorum yapıp yapamayacağını kontrol eden seçenekler.

shareableUrl

string

Paylaşılan Google Fotoğraflar albümünün bağlantısı. Bağlantıya sahip olan herkes albümün içeriğini görüntüleyebilir. Bu nedenle, bağlantıyı dikkatli bir şekilde paylaşın.

shareableUrl parametresi yalnızca albümde bağlantı paylaşımı etkinse döndürülür. Bağlantıyla paylaşılmayan bir albüme zaten katılmış olan kullanıcılar, albüme erişmek için albümün productUrl simgesini kullanabilir.

Sahibi Google Fotoğraflar uygulamasında bağlantı paylaşımını devre dışı bırakırsa veya albümün paylaşımı kaldırılırsa shareableUrl geçersiz hale gelir.

shareToken

string

Paylaşılan bir albüme katılmak, albümden ayrılmak veya albümün sahibi olmayan bir kullanıcı adına albümün ayrıntılarını almak için kullanılan jeton.

Sahibi Google Fotoğraflar uygulamasında bağlantı paylaşımını devre dışı bırakırsa veya albümün paylaşımı kaldırılırsa shareToken geçersiz hale gelir.

isJoined

boolean

Kullanıcı albüme katıldıysa doğru değerini alır. Bu durum, albümün sahibi için her zaman geçerlidir.

isOwned

boolean

Kullanıcı albümün sahibiyse doğru değerini alır.

isJoinable

boolean

Albüme kullanıcılar katılabilirse doğru değerini döndürür.

SharedAlbumOptions

Albümün paylaşımını kontrol eden seçenekler.

JSON gösterimi
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
Alanlar
isCollaborative

boolean

Paylaşılan albüm, ortak çalışanların (albüme katılan kullanıcılar) medya öğeleri eklemesine izin veriyorsa doğru değerini döndürür. Varsayılan değer yanlıştır.

isCommentable

boolean

Paylaşılan albümde ortak çalışanların (albüme katılan kullanıcılar) albüme yorum eklemesine izin veriliyor ise doğru değerini alır. Varsayılan değer yanlıştır.

Yöntemler

addEnrichment

Uygulama tarafından oluşturulan bir albümde belirtilen bir konuma zenginleştirme ekler.

batchAddMediaItems

Kullanıcının Google Fotoğraflar kitaplığındaki bir veya daha fazla uygulama tarafından oluşturulan medya öğesini uygulama tarafından oluşturulan bir albüme ekler.

batchRemoveMediaItems

Belirtilen uygulama tarafından oluşturulan albümden uygulama tarafından oluşturulan bir veya daha fazla medya öğesini kaldırır.

create

Kullanıcının Google Fotoğraflar kitaplığında albüm oluşturur.

get

Belirtilen albumId değerine göre uygulama tarafından oluşturulan albümü döndürür.

list

Uygulamanız tarafından oluşturulan tüm albümleri listeler.

patch

Uygulama tarafından oluşturulan albümü belirtilen id ile güncelleyin.