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