عندما ينقر المستخدم على زر "جديد" في واجهة مستخدم 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: رقم تعريف الملف الشخصي الذي يعرّف المستخدم بشكل فريد.
يجب أن يتعامل تطبيقك مع هذا الطلب من خلال اتّباع الخطوات التالية:
- تحقَّق من أنّ قيمة الحقل
action
هيcreate
. - استخدِم القيمة
userId
لإنشاء جلسة جديدة للمستخدم. لمزيد من المعلومات عن المستخدمين الذين سجّلوا دخولهم، يُرجى مراجعة المستخدمون والأحداث الجديدة. - استخدِم طريقة
files.create
لإنشاء مورد ملف. إذا تم ضبطfolderId
على الطلب، اضبط الحقلparents
على القيمةfolderId
. - في حال ضبط
folderResourceKey
على الطلب، عليك ضبط عنوان الطلبX-Goog-Drive-Resource-Keys
. لمزيد من المعلومات حول مفاتيح الموارد، يُرجى الاطّلاع على الوصول إلى الملفات المشتركة باستخدام روابط باستخدام مفاتيح الموارد.
المعلَمة state
مرمّزة بعنوان URL، لذا يجب على تطبيقك معالجة أحرف الإلغاء وتحليلها بتنسيق JSON.
المستخدمون والأحداث الجديدة
يجب أن تتعامل تطبيقات Drive مع جميع أحداث "الإنشاء" باعتبارها عمليات تسجيل دخول محتملة. قد يمتلك بعض المستخدمين حسابات متعددة، لذلك قد لا يتطابق رقم تعريف المستخدم في
المَعلمة state
مع الجلسة الحالية. إذا كان رقم تعريف المستخدم في المعلَمة state
لا يتطابق مع الجلسة الحالية، عليك إنهاء الجلسة الحالية لتطبيقك وتسجيل الدخول باسم المستخدم المطلوب.