REST Resource: albums

Kaynak: Albüm

Bir albümün Google Fotoğraflar'daki temsili. Albümler medya öğelerinin kapsayıcısıdır. Bir albüm uygulama tarafından paylaşılmışsa bu albüm fazladan bir shareInfo özelliği içerir.

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ı. Oturumlar arasında bu albümü tanımlamak için kullanılabilecek kalıcı bir tanımlayıcıdır.
title

string

Kullanıcının Google Fotoğraflar hesabında gördüğü albümün adı. Bu dize 500 karakterden uzun olmamalıdır.
productUrl

string

[Yalnızca çıkış] Albümün Google Fotoğraflar URL'si. Bu bağlantıya erişmek için kullanıcının 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, verilen kapsamlara ve albümün izinlerine bağlıdır. Kapsamlar veya albümün izinleri değiştirilirse 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, albümü geliştirici 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 değer 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' seçeneği kapak fotoğrafının boyutlarını 2048 piksel genişliğinde ve 1024 piksel olacak şekilde ayarlar.
coverPhotoMediaItemId

string

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

ShareInfo

Paylaşılan albümler hakkında bilgiler. Bu bilgiler yalnızca albümü siz oluşturduysanız, paylaşılırsa ve paylaşım kapsamına sahipseniz 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 öğeleri ekleyip ekleyemeyeceğini veya yorum yapıp yapamayacağını belirleyen 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 albümdeki içerikler dikkatli bir şekilde ele alınmalıdır.

shareableUrl parametresi yalnızca albümde bağlantı paylaşımı açıksa döndürülür. Bağlantıyla paylaşılmayan bir albüme zaten katılmış olan kullanıcılar albüme productUrl üzerinden erişebilir.

Albüm 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 olur.
shareToken

string

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

Albüm 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 olur.
isJoined

boolean

Kullanıcı albüme katılmışsa true değerini alır. Bu durum albümün sahibi için her zaman geçerlidir.
isOwned

boolean

Albümün sahibi kullanıcıysa doğru değerini alır.
isJoinable

boolean

Kullanıcılar albüme katılabiliyorsa true değerini alır.

SharedAlbumOptions

Albümün paylaşımını denetleyen 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) albüme medya öğeleri eklemesine izin veriyorsa doğru değerini alır. Varsayılan olarak false değerine ayarlanır.
isCommentable

boolean

Paylaşılan albüm, ortak çalışanların (albüme katılan kullanıcılar) albüme yorum eklemesine izin veriyorsa doğru değerini alır. Varsayılan olarak false değerine ayarlanır.

Yöntemler

addEnrichment

 Tanımlı bir albümde belirli bir konuma zenginleştirme ekler.

batchAddMediaItems

 Kullanıcının Google Fotoğraflar kitaplığındaki bir veya daha fazla medya öğesini bir albüme ekler.

batchRemoveMediaItems

 Belirtilen albümden 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 albümü döndürür.

list

 Google Fotoğraflar uygulamasının Albümler sekmesinde bir kullanıcıya gösterilen tüm albümleri listeler.

patch

 Albümü, belirtilen id ile güncelleyin.

share

 Albümü paylaşıldı ve diğer kullanıcılar tarafından erişilebilir olarak işaretler.

unshare

 Daha önce paylaşılan bir albümü gizli olarak işaretler.