Google Photos Library API ile ilgili eski dokümanları görüntülüyorsunuz.
REST Resource: sharedAlbums
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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ı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 500 karakterden uzun olmamalı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ş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, 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 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ı.
|
Yöntemler |
|
|
Belirtilen shareToken değerine göre albümü döndürür. |
|
|
Google Fotoğraflar kullanıcısı adına paylaşılan bir albüme katılır. |
|
|
Google Fotoğraflar kullanıcısı adına daha önce katılmış bir paylaşılan albümden ayrılır. |
|
|
Kullanıcının Google Fotoğraflar uygulamasındaki Paylaşım sekmesinde bulunan tüm paylaşılan albümleri listeler. |
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-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[[["\u003cp\u003eAlbums in Google Photos are containers for media items and can be shared.\u003c/p\u003e\n"],["\u003cp\u003eShared albums have a \u003ccode\u003eshareInfo\u003c/code\u003e property and developers can access them with the \u003ccode\u003ephotoslibrary.sharing\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eAlbum\u003c/code\u003e resource provides methods to get, join, leave, and list shared albums.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAlbum\u003c/code\u003e properties provide information such as ID, title, URL, writability status, media count, and cover photo details.\u003c/p\u003e\n"]]],["Albums in Google Photos are containers for media items, identified by a unique `id` and a user-facing `title`. Key details include the album's `productUrl`, whether it's `isWriteable`, `mediaItemsCount`, and cover photo information (`coverPhotoBaseUrl`, `coverPhotoMediaItemId`). Shared albums contain a `shareInfo` property. Actions include: retrieving albums with a `shareToken`, joining, leaving, and listing shared albums via methods such as `get`, `join`, `leave`, and `list`.\n"],null,["# REST Resource: sharedAlbums\n\n- [Resource: Album](#Album)\n - [JSON representation](#Album.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Album\n---------------\n\nRepresentation of an album in Google Photos. Albums are containers for media items. If an album has been shared by the application, it contains an extra `shareInfo` property.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"title\": string, \"productUrl\": string, \"isWriteable\": boolean, \"shareInfo\": { object (/photos/library/legacy/reference/rest/v1/albums#Album.ShareInfo) }, \"mediaItemsCount\": string, \"coverPhotoBaseUrl\": string, \"coverPhotoMediaItemId\": string } ``` |\n\n| Fields ||\n|-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Identifier for the album. This is a persistent identifier that can be used between sessions to identify this album. |\n| `title` | `string` Name of the album displayed to the user in their Google Photos account. This string shouldn't be more than 500 characters. |\n| `productUrl` | `string` \\[Output only\\] Google Photos URL for the album. The user needs to be signed in to their Google Photos account to access this link. |\n| `isWriteable` | `boolean` \\[Output only\\] True if you can create media items in this album. This field is based on the scopes granted and permissions of the album. If the scopes are changed or permissions of the album are changed, this field is updated. |\n| `shareInfo` | `object (`[ShareInfo](/photos/library/legacy/reference/rest/v1/albums#Album.ShareInfo)`)` \\[Output only\\] Information related to shared albums. This field is only populated if the album is a shared album, the developer created the album and the user has granted the `photoslibrary.sharing` scope. |\n| `mediaItemsCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` \\[Output only\\] The number of media items in the album. |\n| `coverPhotoBaseUrl` | `string` \\[Output only\\] A URL to the cover photo's bytes. This shouldn't be used as is. Parameters should be appended to this URL before use. See the [developer documentation](https://developers.google.com/photos/library/guides/access-media-items#base-urls) for a complete list of supported parameters. For example, `'=w2048-h1024'` sets the dimensions of the cover photo to have a width of 2048 px and height of 1024 px. |\n| `coverPhotoMediaItemId` | `string` Identifier for the media item associated with the cover photo. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------|---------------------------------------------------------------------------------------|\n| ### [get](/photos/library/legacy/reference/rest/v1/sharedAlbums/get) | Returns the album based on the specified `shareToken`. |\n| ### [join](/photos/library/legacy/reference/rest/v1/sharedAlbums/join) | Joins a shared album on behalf of the Google Photos user. |\n| ### [leave](/photos/library/legacy/reference/rest/v1/sharedAlbums/leave) | Leaves a previously-joined shared album on behalf of the Google Photos user. |\n| ### [list](/photos/library/legacy/reference/rest/v1/sharedAlbums/list) | Lists all shared albums available in the Sharing tab of the user's Google Photos app. |"]]
