أنت تعرض المستندات القديمة لواجهة برمجة التطبيقات Google Photos Library API.
Method: albums.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض الألبوم استنادًا إلى albumId المحدد. يجب أن يكون albumId هو رقم تعريف ألبوم يملكه المستخدم أو ألبوم مشترَك انضم إليه.
طلب HTTP
GET https://photoslibrary.googleapis.com/v1/albums/{albumId}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
albumId |
string
مطلوب. معرّف الألبوم المطلوب
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Album.
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis endpoint retrieves a specific album using its unique identifier (\u003ccode\u003ealbumId\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe request must include the \u003ccode\u003ealbumId\u003c/code\u003e of an album the user owns or has joined as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eAn empty request body is required, and a successful response returns the album details.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using one of the specified OAuth scopes for Photos Library access.\u003c/p\u003e\n"]]],["This outlines retrieving an album via a `GET` request to `https://photoslibrary.googleapis.com/v1/albums/{albumId}`, where `albumId` is a required path parameter. The request body must be empty. A successful response returns an `Album` instance. Authorization requires one of three specified OAuth scopes. Only the album owner or members of a shared album can use the albumId to retreive the album.\n"],null,["# Method: albums.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 `albumId`. The `albumId` must be the ID of an album owned by the user or a shared album that the user has joined.\n\n### HTTP request\n\n`GET https://photoslibrary.googleapis.com/v1/albums/{albumId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------|\n| `albumId` | `string` Required. Identifier 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 one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/photoslibrary`\n- `\n https://www.googleapis.com/auth/photoslibrary.readonly`\n- `\n https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata`"]]
