Вы просматриваете устаревшую документацию по API библиотеки Google Фото.
Method: sharedAlbums.join
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Присоединяется к общему альбому от имени пользователя Google Фото.
HTTP-запрос
POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные следующей структуры:
| JSON-представление |
|---|
{
"shareToken": string
} |
| Поля |
|---|
shareToken | string Необходимый. Токен для присоединения к общему альбому от имени пользователя. |
Тело ответа
Ответ на успешное присоединение к общему альбому от имени пользователя.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"album": {
object (Album)
}
} |
| Поля |
|---|
album | object ( Album ) Общий альбом, к которому присоединился пользователь. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/photoslibrary.sharing
,
Присоединяется к общему альбому от имени пользователя Google Фото.
HTTP-запрос
POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные следующей структуры:
| JSON-представление |
|---|
{
"shareToken": string
} |
| Поля |
|---|
shareToken | string Необходимый. Токен для присоединения к общему альбому от имени пользователя. |
Тело ответа
Ответ на успешное присоединение к общему альбому от имени пользователя.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"album": {
object (Album)
}
} |
| Поля |
|---|
album | object ( Album ) Общий альбом, к которому присоединился пользователь. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/photoslibrary.sharing
,
Присоединяется к общему альбому от имени пользователя Google Фото.
HTTP-запрос
POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные следующей структуры:
| JSON-представление |
|---|
{
"shareToken": string
} |
| Поля |
|---|
shareToken | string Необходимый. Токен для присоединения к общему альбому от имени пользователя. |
Тело ответа
Ответ на успешное присоединение к общему альбому от имени пользователя.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"album": {
object (Album)
}
} |
| Поля |
|---|
album | object ( Album ) Общий альбом, к которому присоединился пользователь. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/photoslibrary.sharing
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[[["\u003cp\u003eJoins a shared album on behalf of a Google Photos user using a provided share token.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a shareToken to initiate the joining process.\u003c/p\u003e\n"],["\u003cp\u003eA successful response includes the details of the shared album the user has joined.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/photoslibrary.sharing\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["A POST request is made to `https://photoslibrary.googleapis.com/v1/sharedAlbums:join` to join a shared album. The request body, in JSON format, requires a `shareToken` string. The successful response body contains an `album` object, also in JSON format, representing the joined shared album. Authorization for this action requires the `https://www.googleapis.com/auth/photoslibrary.sharing` OAuth scope. This uses gRPC transcoding syntax.\n"],null,["# Method: sharedAlbums.join\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.JoinSharedAlbumResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nJoins a shared album on behalf of the Google Photos user.\n\n### HTTP request\n\n`POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------|\n| ``` { \"shareToken\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------|\n| `shareToken` | `string` Required. Token to join the shared album on behalf of the user. |\n\n### Response body\n\nResponse to successfully joining the shared album on behalf of the user.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------|\n| ``` { \"album\": { object (/photos/library/legacy/reference/rest/v1/albums#Album) } } ``` |\n\n| Fields ||\n|---------|--------------------------------------------------------------------------------------------------------------------|\n| `album` | `object (`[Album](/photos/library/legacy/reference/rest/v1/albums#Album)`)` Shared album that the user has joined. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/photoslibrary.sharing`"]]
