Method: sessions.create

يتم إنشاء جلسة جديدة يمكن للمستخدم خلالها اختيار الصور والفيديوهات للوصول إليها من خلال جهة خارجية.

إذا لم يكن لدى المستخدم حساب نشط على "صور Google"، يتم عرض خطأ FAILED_PRECONDITION.

إذا أنشأ تطبيق العميل عددًا كبيرًا جدًا من الجلسات لكل مستخدم، يتم عرض خطأ RESOURCE_EXHAUSTED. من غير المرجّح أن يصل العملاء إلى هذه الحدود في الظروف العادية. ومع ذلك، يُنصح العملاء بالاتصال برقم sessions.delete بعد كل جلسة، للبقاء ضمن حدود الموارد بشكل استباقي.

بعد أن ينقر المستخدم على الزر تم لإكمال جلسة اختيار، لن يعمل الرمز pickerUri بعد ذلك. أنشئ جلسة جديدة للسماح للمستخدم باختيار المزيد من الصور.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات طلب البحث

المعلمات
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