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