یک جلسه جدید ایجاد می کند که در طی آن کاربر می تواند عکس ها و فیلم ها را برای دسترسی شخص ثالث انتخاب کند.
اگر کاربر یک حساب 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