تشرح مبادئ التشغيل السريعة كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة التطبيقات في Google Workspace.
تستخدِم عمليات الإعداد السريع في Google Workspace مكتبات عملاء واجهة برمجة التطبيقات لمعالجة بعض تفاصيل عملية المصادقة والتفويض. ننصح بما يلي: استخدام مكتبات البرامج لتطبيقاتك الخاصة. تستخدم هذه البدء السريع وهو نهج مصادقة مبسط مناسب للاختبار محددة. بالنسبة إلى بيئة الإنتاج، ننصحك بالاطّلاع على معلومات عن المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول الملائمة لتطبيقك.
يمكنك إنشاء تطبيق سطر أوامر Java لإرسال طلبات إلى واجهة برمجة التطبيقات Google Apps Script API.
الأهداف
- إعداد البيئة.
- إعداد العيّنة
- شغِّل العيّنة.
المتطلبات الأساسية
- الإصدار 1.8 من Java أو إصدار أحدث.
- الإصدار 7.0 من Gradle أو إصدار أحدث
- مشروع على Google Cloud:
- حساب Google مع تفعيل Google Drive.
إعداد البيئة
لإكمال هذا البدء السريع، عليك إعداد البيئة الخاصة بك.
تفعيل واجهة برمجة التطبيقات
قبل استخدام واجهات برمجة تطبيقات Google، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في وحدة تحكُّم Google Cloud، فعِّل واجهة برمجة التطبيقات Google Apps Script API.
ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
إذا كنت تستخدم مشروعًا جديدًا على Google Cloud لإكمال هذه البدء السريع، عليك ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth وإضافة نفسك كمستخدم تجريبي. إذا كنت قد قمت بالفعل أكملت هذه الخطوة لمشروعك على السحابة الإلكترونية، انتقِل إلى القسم التالي.
- في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات الخدمات > شاشة موافقة OAuth. .
- بالنسبة إلى نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
- أكمِل نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.
في الوقت الحالي، يمكنك تخطّي إضافة النطاقات والنقر على حفظ ومتابعة. في المستقبل، عند إنشاء تطبيق للاستخدام خارج Google Workspace، عليك تغيير نوع المستخدم إلى خارجي، وبعد ذلك أضِف نطاقات الأذونات التي يتطلبها تطبيقك.
- مراجعة ملخّص تسجيل التطبيق لإجراء تغييرات، انقر على تعديل. إذا كان تسجيل التطبيق يبدو جيدًا، انقر على الرجوع إلى لوحة البيانات.
تفويض بيانات الاعتماد لتطبيق على الكمبيوتر المكتبي
لمصادقة المستخدمين النهائيين والوصول إلى بيانات المستخدمين في تطبيقك، عليك إجراء ما يلي: إنشاء معرِّف عميل OAuth 2.0 واحد أو أكثر. يُستخدَم معرّف العميل لتحديد تطبيق واحد في خوادم OAuth في Google. إذا كان تطبيقك يعمل على أنظمة أساسية متعدّدة عليك إنشاء معرِّف عميل منفصل لكل منصّة.- في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات الخدمات > بيانات الاعتماد.
- انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
- انقر على نوع التطبيق > تطبيق الكمبيوتر المكتبي.
- في حقل الاسم، اكتب اسمًا لبيانات الاعتماد. ولا يظهر هذا الاسم إلا في "وحدة تحكّم Google Cloud".
- انقر على إنشاء. تظهر شاشة "تم إنشاء عميل OAuth"، والتي تعرض معرّف العميل الجديد وسرّه.
- انقر على موافق. تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن معرّفات عميل OAuth 2.0.
- حفظ ملف JSON الذي تم تنزيله باسم
credentials.json
، ونقل ملف إلى دليل العمل.
إعداد مساحة العمل
في دليل العمل، أنشئ بنية مشروع جديدة:
gradle init --type basic mkdir -p src/main/java src/main/resources
في دليل
src/main/resources/
، انسخ الملفcredentials.json
. الذي قمت بتنزيله مسبقًا.افتح ملف
build.gradle
التلقائي واستبدِل محتواه الرمز التالي:
إعداد العيّنة
في دليل
src/main/java/
، أنشِئ ملف Java جديدًا باسم تتطابق مع القيمةmainClassName
في ملفbuild.gradle
.أدرِج الرمز التالي في ملف Java الجديد:
تنفيذ النموذج
تنفيذ النموذج:
gradle run
-
في المرة الأولى التي تُشغِّل فيها العيّنة، سيُطلب منك تفويض الوصول:
- إذا لم تكن مسجِّلاً الدخول إلى حسابك على Google، سجِّل الدخول عندما يُطلب منك ذلك. إذا كنت مسجِّلاً الدخول إلى حسابات متعددة، اختَر حسابًا واحدًا لاستخدامه في التفويض.
- انقر على قبول.
يتم تشغيل تطبيق Java واستدعائه لواجهة برمجة التطبيقات Google Apps Script API.
يتم تخزين معلومات التفويض في نظام الملفات، لذا عندما تقوم بتشغيل النموذج في المرة التالية الرمز، فلن يُطلب منك منح الإذن.
الخطوات التالية
- المستندات المرجعية لواجهة برمجة التطبيقات لبرمجة التطبيقات
- مستندات برنامج Google APIs للغة Java
- مستندات Javadoc في واجهة برمجة التطبيقات الخاصة ببرمجة Google Apps