تنشئ جلسة جديدة يمكن للمستخدم خلالها اختيار الصور والفيديوهات للوصول إليها من خلال جهات خارجية.
إذا لم يكن لدى المستخدم حساب نشط على "صور Google"، يتم عرض خطأ FAILED_PRECONDITION
.
وإذا أنشأ تطبيق العميل عددًا كبيرًا جدًا من الجلسات لكل مستخدم، سيتم عرض خطأ RESOURCE_EXHAUSTED
. من غير المرجّح أن يصل العملاء إلى هذه الحدود في الظروف العادية. ومع ذلك، لا يزال يُنصح العملاء بالاتصال بـ "sessions.delete
" بعد كل جلسة، للبقاء ضمن حدود الموارد بشكل استباقي.
طلب HTTP
POST https://photospicker.googleapis.com/v1/sessions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على مثال PickingSession
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من PickingSession
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/photospicker.mediaitems.readonly