Przeglądasz starszą dokumentację interfejsu Google Photos Library API.
REST Resource: sharedAlbums
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób: album
Przykładowy album w Zdjęciach Google Albumy to kontenery na elementy multimedialne. Jeśli album został udostępniony przez aplikację, zawiera on dodatkową właściwość shareInfo.
| Zapis JSON |
{
"id": string,
"title": string,
"productUrl": string,
"isWriteable": boolean,
"shareInfo": {
object (ShareInfo)
},
"mediaItemsCount": string,
"coverPhotoBaseUrl": string,
"coverPhotoMediaItemId": string
} |
| Pola |
id |
string
Identyfikator albumu. Jest to trwały identyfikator, który może być używany w różnych sesjach do identyfikacji tego albumu.
|
title |
string
Nazwa albumu wyświetlanego użytkownikowi na jego koncie Zdjęć Google. Ciąg nie może zawierać więcej niż 500 znaków.
|
productUrl |
string
[Tylko dane wyjściowe] Adres URL Zdjęć Google dla albumu. Aby uzyskać dostęp do tego linku, użytkownik musi zalogować się na swoje konto Zdjęć Google.
|
isWriteable |
boolean
[Tylko dane wyjściowe] Prawda, jeśli można tworzyć elementy multimedialne w tym albumie. To pole zależy od przyznanych zakresów i uprawnień do albumu. To pole jest aktualizowane w przypadku zmiany zakresów lub uprawnień w albumie.
|
shareInfo |
object (ShareInfo)
[Tylko dane wyjściowe] Informacje związane z albumami udostępnionymi. To pole jest wypełniane tylko wtedy, gdy album jest albumem udostępnionym, utworzył go deweloper, a użytkownik przyznał zakres photoslibrary.sharing.
|
mediaItemsCount |
string (int64 format)
[Tylko dane wyjściowe] Liczba elementów multimedialnych w albumie.
|
coverPhotoBaseUrl |
string
[Tylko dane wyjściowe] URL do bajtów zdjęcia na okładkę. Nie należy go używać w postaci, w której został podany. Przed użyciem do tego adresu URL należy dołączyć parametry. Pełną listę obsługiwanych parametrów znajdziesz w dokumentacji dla programistów. Na przykład funkcja '=w2048-h1024' ustawia wymiary zdjęcia na okładkę na 2048 pikseli i wysokość 1024 piksele.
|
coverPhotoMediaItemId |
string
Identyfikator elementu multimedialnego powiązanego ze zdjęciem na okładkę.
|
Metody |
|
|
Zwraca album na podstawie określonego shareToken. |
|
|
Dołącza do udostępnionego albumu w imieniu użytkownika Zdjęć Google. |
|
|
opuszcza wcześniej dołączony album udostępniony w imieniu użytkownika Zdjęć Google; |
|
|
Wyświetla listę wszystkich udostępnionych albumów dostępnych na karcie Udostępnianie w aplikacji Zdjęcia Google użytkownika. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
