Method: sessions.create

یک جلسه جدید ایجاد می کند که در طی آن کاربر می تواند عکس ها و فیلم ها را برای دسترسی شخص ثالث انتخاب کند.

اگر کاربر یک حساب Google Photos فعال نداشته باشد، یک خطای FAILED_PRECONDITION برگردانده می شود.

اگر برنامه سرویس گیرنده تعداد جلسات زیادی را برای هر کاربر ایجاد کند، یک خطای RESOURCE_EXHAUSTED برگردانده می شود. بعید است که مشتریان در شرایط عادی به این محدودیت ها برسند. با این حال، همچنان به مشتریان توصیه می شود که پس از هر جلسه با sessions.delete تماس بگیرند تا فعالانه در محدوده منابع باقی بمانند.

درخواست HTTP

POST https://photospicker.googleapis.com/v1/sessions

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست شامل نمونه ای از PickingSession است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از PickingSession است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly