با Picker API جدید و تغییرات مهم Library API آشنا شوید.
جزئیات اینجا
Method: sessions.create
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک جلسه جدید ایجاد می کند که در طی آن کاربر می تواند عکس ها و فیلم ها را برای دسترسی شخص ثالث انتخاب کند.
اگر کاربر یک حساب Google Photos فعال نداشته باشد، یک خطای FAILED_PRECONDITION برگردانده می شود.
اگر برنامه سرویس گیرنده تعداد جلسات زیادی را برای هر کاربر ایجاد کند، یک خطای RESOURCE_EXHAUSTED برگردانده می شود. بعید است که مشتریان در شرایط عادی به این محدودیت ها برسند. با این حال، همچنان به مشتریان توصیه می شود که پس از هر جلسه با sessions.delete تماس بگیرند تا فعالانه در محدوده منابع باقی بمانند.
هنگامی که کاربر برای تکمیل یک جلسه انتخاب، دکمه Done را بزند ، pickerUri دیگر کار نخواهد کرد. یک جلسه جدید ایجاد کنید تا کاربر بتواند عکس های بیشتری را انتخاب کند.
درخواست HTTP
POST https://photospicker.googleapis.com/v1/sessions
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
| پارامترها |
|---|
requestId | string اختیاری. یک شناسه منحصر به فرد ارائه شده توسط مشتری برای این درخواست. این شناسه برای فعال کردن تجربه انتخاب ساده برای برنامه‌هایی که از جریان OAuth 2.0 برای دستگاه‌های ورودی محدود استفاده می‌کنند استفاده می‌شود. این شناسه باید فرمت یک رشته UUID (نسخه 4) داشته باشد و شرایط زیر را رعایت کند: - نباید حاوی هیچ گونه اطلاعات شناسایی حساس در مورد کاربر باشد.
- باید شامل 32 نویسه هگزا دسیمال باشد که به پنج گروه جدا شده با خط تیره، با قالب "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (یا 8-4-4-4-12) تقسیم شده اند.
|
درخواست بدن
بدنه درخواست شامل نمونه ای از PickingSession است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از PickingSession است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis endpoint creates a session for users to select photos and videos for third-party access.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003eFAILED_PRECONDITION\u003c/code\u003e error occurs if the user lacks an active Google Photos account.\u003c/p\u003e\n"],["\u003cp\u003eExcessive session creation leads to a \u003ccode\u003eRESOURCE_EXHAUSTED\u003c/code\u003e error, though unlikely under normal use.\u003c/p\u003e\n"],["\u003cp\u003eClients should call \u003ccode\u003esessions.delete\u003c/code\u003e after each session to avoid exceeding resource limits.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/photospicker.mediaitems.readonly\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This describes the creation of a new session for users to grant third-party access to their photos and videos. It uses a `POST` request to `https://photospicker.googleapis.com/v1/sessions`. The request body contains a `PickingSession` instance, and a successful response returns a new `PickingSession`. Requires `photospicker.mediaitems.readonly` OAuth scope. Errors include `FAILED_PRECONDITION` for inactive accounts and `RESOURCE_EXHAUSTED` for excessive session creation. Deleting sessions with `sessions.delete` is recommended to manage resources.\n"],null,[]]
