REST Resource: albums

Kaynak: Albüm

Bir albümün Google Fotoğraflar'daki gösterimi. Albümler, medya öğelerinin kapsayıcılarıdır. Bir albüm uygulama tarafından paylaşıldıysa 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ı. Bu, albümü tanımlamak için oturumlar arasında 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 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, albümün verilen kapsamlarına ve izinlerine 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, albüm geliştirici tarafından oluşturulduysa 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ına ait URL. Bu şekilde 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 içeriğini görüntüleyebilir. Bu nedenle, bağlantıya dikkatle yaklaşılması gerekir.

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, ilgili albüme erişmek için albümün productUrl bağlantısını kullanabilir.

Sahibi Google Fotoğraflar uygulamasında bağlantı paylaşımını devre dışı bırakırsa veya albüm paylaşılmazsa shareableUrl geçersiz olur.
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 paylaşılmazsa shareToken geçersiz olur.
isJoined

boolean

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

boolean

Albümün sahibi kullanıcıya aitse doğru değerini döndürür.
isJoinable

boolean

Kullanıcılar albüme katılabiliyorsa 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üm, ortak çalışanların (albüme katılan kullanıcılar) albüme yorum eklemesine izin veriyorsa doğru değerini döndürür. Varsayılan olarak yanlış değerine ayarlanır.

Yöntemler

addEnrichment

 Tanımlanmış bir albümdeki 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 kullanıcıya gösterilen tüm albümleri listeler.

patch

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

share

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

unshare

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