REST Resource: albums
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: Albüm
Google Fotoğraflar'daki bir albümün temsili. Albümler, medya öğelerinin kapsayıcısıdır. Uygulama tarafından paylaşılan albümlerde ek bir shareInfo
mülkü bulunur.
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ı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 en fazla 500 karakter uzunluğunda olmalıdır.
|
productUrl |
string
[Yalnızca çıkış] Albümün Google Fotoğraflar URL'si. Kullanıcının bu bağlantıya erişmek için 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 izinlerine ve verilen kapsamlara 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, 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ının URL'si. Bu URL 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ş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ün içeriğini görüntüleyebilir. Bu nedenle, bağlantıyı dikkatli bir şekilde paylaşın. 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.
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 hale gelir.
|
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ün paylaşımı kaldırılırsa shareToken geçersiz hale gelir.
|
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
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
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.
|
Yöntemler |
|
Uygulama tarafından oluşturulan bir albümde belirtilen bir konuma zenginleştirme ekler. |
|
Kullanıcının Google Fotoğraflar kitaplığındaki bir veya daha fazla uygulama tarafından oluşturulan medya öğesini uygulama tarafından oluşturulan bir albüme ekler. |
|
Belirtilen uygulama tarafından oluşturulan albümden uygulama tarafından oluşturulan bir veya daha fazla medya öğesini kaldırır. |
|
Kullanıcının Google Fotoğraflar kitaplığında albüm oluşturur. |
|
Belirtilen albumId değerine göre uygulama tarafından oluşturulan albümü döndürür. |
|
Uygulamanız tarafından oluşturulan tüm albümleri listeler. |
|
Uygulama tarafından oluşturulan albümü belirtilen id ile güncelleyin. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-04-01 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-04-01 UTC."],[[["Google Photos Albums are containers for media items and can be shared with others."],["Shared albums have properties controlling adding media and comments, along with shareable links and tokens."],["Albums include metadata such as title, product URL, cover photo, and media item count."],["Developers can programmatically manage albums using various methods like create, get, list, and update."],["Some album management method scopes are subject to removal or change."]]],["Google Photos albums, serving as media containers, include properties like `id`, `title`, and `productUrl`. Shared albums have `shareInfo`, which contains a `shareableUrl`, `shareToken`, and booleans for user interaction (`isJoined`, `isOwned`, `isJoinable`). Sharing options (`SharedAlbumOptions`) determine collaboration (`isCollaborative`) and commenting (`isCommentable`). Methods for albums include adding/removing media, creating, retrieving, updating (patching), and managing sharing (share/unshare, which will stop working after March 31, 2025).\n"]]