الدمج مع الزر "جديد" لواجهة مستخدم Drive

عندما ينقر المستخدم على زر "جديد" في واجهة مستخدم Drive ويختار تطبيقًا في واجهة مستخدم Drive، يعيد Drive توجيه المستخدم إلى عنوان URL الجديد لهذا التطبيق المحدّد في ضبط عملية دمج واجهة مستخدم Drive.

بعد ذلك، يتلقّى تطبيقك مجموعة تلقائية من متغيّرات النماذج ضمن مَعلمة state. معلومات state التلقائية لعنوان URL الجديد هي:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

يتضمن هذا الناتج القيم التالية:

  • create: الإجراء الذي يتم تنفيذه تكون القيمة create عندما ينقر المستخدم على الزر "جديد" في واجهة مستخدم Drive.
  • FOLDER_ID: رقم تعريف المجلد الرئيسي
  • FOLDER_RESOURCE_KEY: مفتاح المورد للمجلد الرئيسي
  • USER_ID: رقم تعريف الملف الشخصي الذي يعرّف المستخدم بشكل فريد.

يجب أن يتعامل تطبيقك مع هذا الطلب من خلال اتّباع الخطوات التالية:

  1. تحقَّق من أنّ قيمة الحقل action هي create.
  2. استخدِم القيمة userId لإنشاء جلسة جديدة للمستخدم. لمزيد من المعلومات عن المستخدمين الذين سجّلوا دخولهم، يُرجى مراجعة المستخدمون والأحداث الجديدة.
  3. استخدِم طريقة files.create لإنشاء مورد ملف. إذا تم ضبط folderId على الطلب، اضبط الحقل parents على القيمة folderId.
  4. في حال ضبط folderResourceKey على الطلب، عليك ضبط عنوان الطلب X-Goog-Drive-Resource-Keys. لمزيد من المعلومات حول مفاتيح الموارد، يُرجى الاطّلاع على الوصول إلى الملفات المشتركة باستخدام روابط باستخدام مفاتيح الموارد.

المعلَمة state مرمّزة بعنوان URL، لذا يجب على تطبيقك معالجة أحرف الإلغاء وتحليلها بتنسيق JSON.

المستخدمون والأحداث الجديدة

يجب أن تتعامل تطبيقات Drive مع جميع أحداث "الإنشاء" باعتبارها عمليات تسجيل دخول محتملة. قد يمتلك بعض المستخدمين حسابات متعددة، لذلك قد لا يتطابق رقم تعريف المستخدم في المَعلمة state مع الجلسة الحالية. إذا كان رقم تعريف المستخدم في المعلَمة state لا يتطابق مع الجلسة الحالية، عليك إنهاء الجلسة الحالية لتطبيقك وتسجيل الدخول باسم المستخدم المطلوب.