REST Resource: albums

Kaynak: Albüm

Google Fotoğraflar'da bir albümün temsili. Albümler, medya öğeleri için kapsayıcılardır. Uygulama bir albüm paylaştıysa 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ı. Bu albümü tanımlamak için oturumlarda kullanılabilecek 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 500 karakterden uzun olamaz.

productUrl

string

[Yalnızca çıkış] Albüme ait 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şturabilirseniz geçerlidir. Bu alan, verilen kapsamları ve albümün izinlerini temel alı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, geliştirici albümü oluşturduysa ve kullanıcı photoslibrary.sharing kapsamını belirlediyse 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ı için URL. Bu 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şliğine ve 1024 piksel yüksekliğine ayarlar.

coverPhotoMediaItemId

string

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

Paylaşım Bilgileri

Paylaşılan albümler hakkında bilgi. Bu bilgiler yalnızca albümü siz oluşturduysanız ve albüm paylaşılmışsa 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)

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

shareableUrl

string

Paylaşılan Google Fotoğraflar albümü için bir bağlantı. Bağlantıya sahip olan herkes albümün içeriğini görüntüleyebilir, bu nedenle dikkatle yaklaşın.

shareableUrl parametresi yalnızca albüm için bağlantı paylaşımı etkinse döndürülür. Bir kullanıcı, bağlantıyla paylaşılmayan bir albüme zaten katıldıysa bunun yerine albüme erişmek için albümün productUrl ürününü kullanabilir.

Sahibi Google Fotoğraflar uygulamasında bağlantı paylaşımını devre dışı bırakmışsa veya albüm paylaşımı kaldırılmışsa shareableUrl geçersiz olur.

shareToken

string

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

Sahibi Google Fotoğraflar uygulamasında bağlantı paylaşımını devre dışı bırakmışsa veya albüm paylaşımı kaldırılmışsa shareToken geçersiz olur.

isJoined

boolean

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

isOwned

boolean

Albümün sahibi kullanıcıysa doğrudur.

isJoinable

boolean

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

PaylaşılanAlbümSeçenekleri

Bir 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) albüme medya öğeleri eklemesine izin veriyorsa doğru değerini alır. Varsayılan olarak false'tur.

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'tur.

Yöntemler

addEnrichment

Tanımlanmış bir albümde belirtilen bir konuma zenginleştirme ekler.

batchAddMediaItems

Bir kullanıcının Google Fotoğraflar kitaplığındaki bir veya daha fazla medya öğesini 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

Albümü belirtilen albumId değerine göre 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

Bir albümü paylaşılan ve diğer kullanıcılar için erişilebilir olarak işaretler.

unshare

Önceden paylaşılan bir albümü gizli olarak işaretler.