شما در حال مشاهده اسناد قدیمی برای Google Photos Library API هستید.
Method: sharedAlbums.join
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
از طرف کاربر Google Photos به یک آلبوم مشترک می پیوندد.
درخواست HTTP
POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"shareToken": string
} |
| فیلدها |
|---|
shareToken | string مورد نیاز. رمز برای پیوستن به آلبوم مشترک از طرف کاربر. |
بدن پاسخگو
پاسخ به پیوستن موفقیت آمیز به آلبوم مشترک از طرف کاربر.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"album": {
object (Album)
}
} |
| فیلدها |
|---|
album | object ( Album ) آلبوم مشترکی که کاربر به آن ملحق شده است. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/photoslibrary.sharing
،
از طرف کاربر Google Photos به یک آلبوم مشترک می پیوندد.
درخواست HTTP
POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"shareToken": string
} |
| فیلدها |
|---|
shareToken | string مورد نیاز. رمز برای پیوستن به آلبوم مشترک از طرف کاربر. |
بدن پاسخگو
پاسخ به پیوستن موفقیت آمیز به آلبوم مشترک از طرف کاربر.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"album": {
object (Album)
}
} |
| فیلدها |
|---|
album | object ( Album ) آلبوم مشترکی که کاربر به آن ملحق شده است. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/photoslibrary.sharing
،
از طرف کاربر Google Photos به یک آلبوم مشترک می پیوندد.
درخواست HTTP
POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"shareToken": string
} |
| فیلدها |
|---|
shareToken | string مورد نیاز. رمز برای پیوستن به آلبوم مشترک از طرف کاربر. |
بدن پاسخگو
پاسخ به پیوستن موفقیت آمیز به آلبوم مشترک از طرف کاربر.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"album": {
object (Album)
}
} |
| فیلدها |
|---|
album | object ( Album ) آلبوم مشترکی که کاربر به آن ملحق شده است. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/photoslibrary.sharing
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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`"]]
