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ı. 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 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şliği ve 1024 piksel yüksekliğinde 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 öğeleri ekleyip ekleyemeyeceğini veya bu albüme yorum yapıp yapamayacağını denetleyen 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 kullanmanız önerilir.

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.

Bir shareableUrl, 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.

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 durum, 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

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ü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

batchAddMediaItems

batchRemoveMediaItems

create

get

list

patch

Albümü belirtilen id ile güncelleyin.

share

unshare