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