أنت تعرض المستندات القديمة لواجهة برمجة التطبيقات Google Photos Library API.
Method: sharedAlbums.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لعرض الألبوم استنادًا إلى shareToken المحدّد.
طلب HTTP
GET https://photoslibrary.googleapis.com/v1/sharedAlbums/{shareToken}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
shareToken |
string
مطلوب. مشاركة الرمز المميز للألبوم المطلوب.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Album.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/photoslibrary.sharing
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a shared album using its unique \u003ccode\u003eshareToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and returns the album details in the response.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003eGET\u003c/code\u003e HTTP method and requires \u003ccode\u003ephotoslibrary.sharing\u003c/code\u003e authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eThe API endpoint follows gRPC Transcoding syntax for the URL structure.\u003c/p\u003e\n"]]],["The core content describes how to retrieve an album using a share token. A `GET` request is sent to the specified URL, including the required `shareToken` as a path parameter. The request body must be empty. A successful response returns an `Album` instance. This operation requires the `https://www.googleapis.com/auth/photoslibrary.sharing` authorization scope, as defined for sharing. There is also a try it option available to users.\n"],null,["# Method: sharedAlbums.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns the album based on the specified `shareToken`.\n\n### HTTP request\n\n`GET https://photoslibrary.googleapis.com/v1/sharedAlbums/{shareToken}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------|\n| `shareToken` | `string` Required. Share token of the album to be requested. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Album](/photos/library/legacy/reference/rest/v1/albums#Album).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/photoslibrary.sharing`"]]
