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