REST Resource: albums

Kaynak: Albüm

Google Fotoğraflar'daki bir albümün 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ıdır. 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ş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ı 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 paylaşılırsa ve paylaşım kapsamına sahipseniz bu bilgiler 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

Sahibi olmayan bir kullanıcının 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.

Bir shareToken, sahibi Google Fotoğraflar uygulamasında bağlantı paylaşımını devre dışı bırakırsa veya albümün paylaşımdan kaldırılırsa geçersiz kılınır.
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

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

Bir 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) medya öğeleri eklemesine izin veriyorsa doğru değerini döndürür. Varsayılan olarak yanlış değerine ayarlanı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 olarak yanlış değerine ayarlanır.

Yöntemler

addEnrichment

 Tanımlanmış 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 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.