الدمج مع الزر "جديد" لواجهة مستخدم 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 مع الجلسة الحالية، عليك إنهاء الجلسة الحالية لتطبيقك وتسجيل الدخول بصفتك المستخدم المطلوب.