Method: sessions.create

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

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

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

طلب HTTP

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

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

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

المعلمات
requestId

string

اختياريّ. معرّف فريد يقدّمه العميل لهذا الطلب.

يُستخدَم هذا المعرّف لتفعيل تجربة الاختيار المبسّطة للتطبيقات التي تستخدم مسار OAuth 2.0 لأجهزة الإدخال المحدودة.

يجب أن يكون رقم التعريف هذا بتنسيق سلسلة رقم تعريف عالمي فريد (الإصدار 4) وأن يستوفي المتطلبات التالية:

  • يجب ألا يحتوي على أي معلومات حسّاسة تحدّد هوية المستخدم.
  • يجب أن يحتوي على 32 حرفًا سداسيًا عشريًا مقسمة إلى خمس مجموعات مفصولة بشرطات، بالتنسيق "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (أو 8-4-4-4-12).

نص الطلب

يحتوي نص الطلب على مثال PickingSession.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من PickingSession.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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