تشرح مشاريع Quickstart كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة تطبيقات Google Workspace.
تستخدم مشاريع البدء السريع في Google Workspace مكتبات عميل واجهة برمجة التطبيقات لمعالجة بعض تفاصيل عملية المصادقة والتفويض. وننصح باستخدام مكتبات العملاء في تطبيقاتك الخاصة يستخدم البدء السريع هذا أسلوب مصادقة مبسطًا ومناسبًا لبيئة الاختبار. بالنسبة إلى بيئة الإنتاج، ننصحك بالتعرّف على معلومات حول المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول المناسبة لتطبيقك.
يمكنك إنشاء تطبيق سطر أوامر Java لإرسال طلبات إلى واجهة برمجة التطبيقات لبرمجة تطبيقات Google.
الأهداف
- إعداد البيئة
- ابدأ إعداد العيّنة.
- شغِّل النموذج.
المتطلبات الأساسية
- الإصدار 1.8 من لغة Java أو إصدار أحدث
- الإصدار 7.0 من Gradle أو الإصدارات الأحدث
- مشروع على Google Cloud:
- حساب Google مع تفعيل Google Drive
إعداد البيئة
لإكمال عملية البدء السريع هذه، عليك إعداد بيئتك.
تفعيل واجهة برمجة التطبيقات
قبل استخدام Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في Google Cloud Console، فعِّل واجهة برمجة التطبيقات لبرمجة تطبيقات Google.
ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
إذا كنت تستخدم مشروعًا جديدًا على Google Cloud لإكمال عملية البدء السريع هذه، يمكنك ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth وإضافة نفسك كمستخدم تجريبي. إذا كنت قد أكملت هذه الخطوة لمشروعك على Google Cloud بالفعل، فانتقل إلى القسم التالي.
- في Google Cloud Console، انتقِل إلى القائمة > واجهات برمجة التطبيقات والخدمات > شاشة موافقة OAuth.
- اختر نوع المستخدِم لتطبيقك، ثم انقر على إنشاء.
- أكمل نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.
في الوقت الحالي، يمكنك تخطّي إضافة النطاقات والنقر على حفظ ومتابعة. في المستقبل، عند إنشاء تطبيق للاستخدام خارج مؤسستك على Google Workspace، عليك إضافة نطاقات التفويض التي يتطلبها تطبيقك والتحقّق منها.
- إذا اخترت خارجي لنوع المستخدم، أضِف المستخدمين الاختباريين:
- ضمن اختبار المستخدمين، انقر على إضافة مستخدمين.
- أدخِل عنوان بريدك الإلكتروني وأي مستخدمين مختبِرين معتمدين آخرين، ثم انقر على حفظ ومتابعة.
- مراجعة ملخص تسجيل التطبيق. لإجراء تغييرات، انقر على تعديل. إذا كان تسجيل التطبيق يبدو على ما يرام، انقر على الرجوع إلى لوحة البيانات.
تفويض بيانات الاعتماد لتطبيق سطح المكتب
للمصادقة كمستخدم نهائي والوصول إلى بيانات المستخدم في تطبيقك، عليك إنشاء معرّف عميل OAuth 2.0 واحد أو أكثر. يُستخدم معرّف العميل لتحديد تطبيق واحد لخوادم OAuth من Google. إذا كان تطبيقك يعمل على أنظمة أساسية متعددة، يجب عليك إنشاء معرِّف عميل منفصل لكل نظام أساسي.- في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
- انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
- انقر على نوع التطبيق > تطبيق سطح المكتب.
- في الحقل الاسم، اكتب اسمًا لبيانات الاعتماد. ولا يظهر هذا الاسم إلا في Google Cloud Console.
- انقر على إنشاء. تظهر الشاشة التي تم إنشاؤها من خلال عميل OAuth، وتعرض معرِّف العميل وسر العميل الجديدين.
- انقر على OK (حسنًا). تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن معرّفات عميل 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
- مستندات JavaScript لواجهة برمجة التطبيقات لبرمجة تطبيقات Google