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.readonly.appcreateddata
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis method retrieves a specific album using its \u003ccode\u003ealbumId\u003c/code\u003e, provided the album is owned by the user or is a shared album they have joined.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires an \u003ccode\u003ealbumId\u003c/code\u003e as a path parameter and an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns an \u003ca href=\"/photos/library/reference/rest/v1/albums#Album\"\u003eAlbum\u003c/a\u003e object containing the album's data.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using one of the specified OAuth scopes, including options for read-only access and accessing app-created data.\u003c/p\u003e\n"],["\u003cp\u003eFunctionality changes are coming in March 2025, limiting interactions to media from your app; see \u003ca href=\"https://developers.google.com/photos/updates.md\"\u003ePhotos APIs updates\u003c/a\u003e for details.\u003c/p\u003e\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 app created album based on the specified `albumId`. The `albumId` must be the ID of an album created by your app.\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/reference/rest/v1/albums#Album).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `\n https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata`"]]
