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