Вы просматриваете устаревшую документацию по API библиотеки Google Фото.
REST Resource: sharedAlbums
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Ресурс: Альбом
Представление альбома в Google Photos. Альбомы — это контейнеры для мультимедийных элементов. Если приложение предоставило общий доступ к альбому, он содержит дополнительное свойство shareInfo .
| JSON-представление |
|---|
{
"id": string,
"title": string,
"productUrl": string,
"isWriteable": boolean,
"shareInfo": {
object (ShareInfo)
},
"mediaItemsCount": string,
"coverPhotoBaseUrl": string,
"coverPhotoMediaItemId": string
} |
| Поля |
|---|
id | string Идентификатор альбома. Это постоянный идентификатор, который можно использовать между сеансами для идентификации этого альбома. |
title | string Название альбома, отображаемое пользователю в его аккаунте Google Фото. Эта строка не должна содержать более 500 символов. |
productUrl | string [Только вывод] URL-адрес альбома в Google Фото. Чтобы получить доступ к этой ссылке, пользователю необходимо войти в свою учетную запись Google Photos. |
isWriteable | boolean [Только вывод] True, если вы можете создавать мультимедийные элементы в этом альбоме. Это поле зависит от предоставленных областей и разрешений альбома. Если изменяются области действия или права доступа к альбому, это поле обновляется. |
shareInfo | object ( ShareInfo ) [Только вывод] Информация, касающаяся общих альбомов. Это поле заполняется только в том случае, если альбом является общим альбомом, разработчик создал альбом и пользователь предоставил область photoslibrary.sharing . |
mediaItemsCount | string ( int64 format) [Только вывод] Количество мультимедийных элементов в альбоме. |
coverPhotoBaseUrl | string [Только вывод] URL-адрес байтов обложки. Это не следует использовать как есть. Перед использованием к этому URL-адресу следует добавить параметры. Полный список поддерживаемых параметров см . в документации разработчика . Например, '=w2048-h1024' устанавливает размеры фотографии обложки: ширина 2048 пикселей и высота 1024 пикселей. |
coverPhotoMediaItemId | string Идентификатор медиа-элемента, связанного с фотографией обложки. |
Методы |
|---|
| Возвращает альбом на основе указанного shareToken . |
| Присоединяется к общему альбому от имени пользователя Google Фото. |
| Выход из общего альбома, к которому ранее присоединился, от имени пользователя Google Фото. |
| Перечисляет все общие альбомы, доступные на вкладке «Общий доступ» в приложении Google Фото пользователя. |
,
Ресурс: Альбом
Представление альбома в Google Photos. Альбомы — это контейнеры для мультимедийных элементов. Если приложение предоставило общий доступ к альбому, он содержит дополнительное свойство shareInfo .
| JSON-представление |
|---|
{
"id": string,
"title": string,
"productUrl": string,
"isWriteable": boolean,
"shareInfo": {
object (ShareInfo)
},
"mediaItemsCount": string,
"coverPhotoBaseUrl": string,
"coverPhotoMediaItemId": string
} |
| Поля |
|---|
id | string Идентификатор альбома. Это постоянный идентификатор, который можно использовать между сеансами для идентификации этого альбома. |
title | string Название альбома, отображаемое пользователю в его аккаунте Google Фото. Эта строка не должна содержать более 500 символов. |
productUrl | string [Только вывод] URL-адрес альбома в Google Фото. Чтобы получить доступ к этой ссылке, пользователю необходимо войти в свою учетную запись Google Photos. |
isWriteable | boolean [Только вывод] True, если вы можете создавать мультимедийные элементы в этом альбоме. Это поле зависит от предоставленных областей и разрешений альбома. Если изменяются области действия или права доступа к альбому, это поле обновляется. |
shareInfo | object ( ShareInfo ) [Только вывод] Информация, касающаяся общих альбомов. Это поле заполняется только в том случае, если альбом является общим альбомом, разработчик создал альбом и пользователь предоставил область photoslibrary.sharing . |
mediaItemsCount | string ( int64 format) [Только вывод] Количество мультимедийных элементов в альбоме. |
coverPhotoBaseUrl | string [Только вывод] URL-адрес байтов обложки. Это не следует использовать как есть. Перед использованием к этому URL-адресу следует добавить параметры. Полный список поддерживаемых параметров см . в документации разработчика . Например, '=w2048-h1024' устанавливает размеры фотографии обложки: ширина 2048 пикселей и высота 1024 пикселей. |
coverPhotoMediaItemId | string Идентификатор медиа-элемента, связанного с фотографией обложки. |
Методы |
|---|
| Возвращает альбом на основе указанного shareToken . |
| Присоединяется к общему альбому от имени пользователя Google Фото. |
| Выход из общего альбома, к которому ранее присоединился, от имени пользователя Google Фото. |
| Перечисляет все общие альбомы, доступные на вкладке «Общий доступ» в приложении Google Фото пользователя. |
,
Ресурс: Альбом
Представление альбома в Google Photos. Альбомы — это контейнеры для мультимедийных элементов. Если приложение предоставило общий доступ к альбому, он содержит дополнительное свойство shareInfo .
| JSON-представление |
|---|
{
"id": string,
"title": string,
"productUrl": string,
"isWriteable": boolean,
"shareInfo": {
object (ShareInfo)
},
"mediaItemsCount": string,
"coverPhotoBaseUrl": string,
"coverPhotoMediaItemId": string
} |
| Поля |
|---|
id | string Идентификатор альбома. Это постоянный идентификатор, который можно использовать между сеансами для идентификации этого альбома. |
title | string Название альбома, отображаемое пользователю в его аккаунте Google Фото. Эта строка не должна содержать более 500 символов. |
productUrl | string [Только вывод] URL-адрес альбома в Google Фото. Чтобы получить доступ к этой ссылке, пользователю необходимо войти в свою учетную запись Google Photos. |
isWriteable | boolean [Только вывод] True, если вы можете создавать мультимедийные элементы в этом альбоме. Это поле зависит от предоставленных областей и разрешений альбома. Если изменяются области действия или права доступа к альбому, это поле обновляется. |
shareInfo | object ( ShareInfo ) [Только вывод] Информация, касающаяся общих альбомов. Это поле заполняется только в том случае, если альбом является общим альбомом, разработчик создал альбом и пользователь предоставил область photoslibrary.sharing . |
mediaItemsCount | string ( int64 format) [Только вывод] Количество мультимедийных элементов в альбоме. |
coverPhotoBaseUrl | string [Только вывод] URL-адрес байтов обложки. Это не следует использовать как есть. Перед использованием к этому URL-адресу следует добавить параметры. Полный список поддерживаемых параметров см . в документации разработчика . Например, '=w2048-h1024' устанавливает размеры фотографии обложки: ширина 2048 пикселей и высота 1024 пикселей. |
coverPhotoMediaItemId | string Идентификатор медиа-элемента, связанного с фотографией обложки. |
Методы |
|---|
| Возвращает альбом на основе указанного shareToken . |
| Присоединяется к общему альбому от имени пользователя Google Фото. |
| Выход из общего альбома, к которому ранее присоединился, от имени пользователя Google Фото. |
| Перечисляет все общие альбомы, доступные на вкладке «Общий доступ» в приложении Google Фото пользователя. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 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. |"]]
