Method: sessions.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تستردّ هذه الدالة معلومات عن الجلسة المحدّدة.
إذا لم تكن الجلسة المحدّدة موجودة أو لم تكن مملوكة للمستخدم، يتم عرض خطأ NOT_FOUND
. إذا كانت الجلسة متوفّرة ولكن انتهت صلاحية الوصول إليها، يتم عرض خطأ PERMISSION_DENIED
.
طلب HTTP
GET https://photospicker.googleapis.com/v1/sessions/{sessionId}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
sessionId |
string
مطلوب. المعرّف الذي أنشأته Google لهذه الجلسة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال PickingSession
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves details about a specific photo picking session using its unique identifier.\u003c/p\u003e\n"],["\u003cp\u003eReturns a \u003ccode\u003eNOT_FOUND\u003c/code\u003e error if the session doesn't exist or isn't owned by the user, and a \u003ccode\u003ePERMISSION_DENIED\u003c/code\u003e error if access has expired.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/photospicker.mediaitems.readonly\u003c/code\u003e scope for accessing session information.\u003c/p\u003e\n"],["\u003cp\u003eProvides the session details in the response body if the request is successful.\u003c/p\u003e\n"]]],["This document outlines the process of retrieving session information via a `GET` request to `https://photospicker.googleapis.com/v1/sessions/{sessionId}`. The `sessionId`, a required string, is provided as a path parameter. The request body must be empty. A successful response returns a `PickingSession` instance, otherwise `NOT_FOUND` or `PERMISSION_DENIED` error. Access requires the `https://www.googleapis.com/auth/photospicker.mediaitems.readonly` OAuth scope. The URL follows gRPC Transcoding syntax.\n"],null,["# Method: sessions.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\nRetrieves information about the specified session.\n\nIf the specified session does not exist or is not owned by the user, a `NOT_FOUND` error is returned. If the session exists but access to the session has expired, a `PERMISSION_DENIED` error is returned.\n\n### HTTP request\n\n`GET https://photospicker.googleapis.com/v1/sessions/{sessionId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------|\n| `sessionId` | `string` Required. The Google-generated identifier for this session. |\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 [PickingSession](/photos/picker/reference/rest/v1/sessions#PickingSession).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/photospicker.mediaitems.readonly`"]]