تشرح أدلة بدء الاستخدام السريع كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة تطبيقات Google Workspace.
تستخدم مشاريع Google Workspace للبدء السريع في استخدام مكتبات برامج واجهة برمجة التطبيقات لمعالجة بعض تفاصيل عملية المصادقة والتفويض. وننصحك باستخدام مكتبات البرامج لتطبيقاتك. يستخدم دليل البدء السريع هذا نهج مصادقة مبسطًا ومناسبًا لبيئة الاختبار. بالنسبة إلى بيئة الإنتاج، نقترح التعرّف على معلومات حول المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول المناسبة لتطبيقك.
أنشئ تطبيق سطر أوامر Go يُرسل الطلبات إلى واجهة برمجة تطبيقات Google Classroom.
الأهداف
- إعداد البيئة:
- عليك إعداد العيّنة.
- شغِّل النموذج.
المتطلبات الأساسية
- أحدث إصدار من تطبيق Go
- أحدث إصدار من Git
- مشروع Google Cloud:
- حساب Google for Education مع تفعيل Google Classroom
إعداد البيئة
لإكمال عملية البدء السريع هذه، عليك إعداد بيئتك.
تفعيل واجهة برمجة التطبيقات
قبل استخدام Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في Google Cloud Console، فعِّل Google Classroom API.
ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
إذا كنت تستخدم مشروعًا جديدًا على Google Cloud لإكمال عملية البدء السريع هذه، عليك ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth وإضافة نفسك كمستخدم تجريبي. إذا كنت قد أكملت هذه الخطوة بالفعل لمشروعك Cloud، انتقل إلى القسم التالي.
- في Google Cloud Console، انتقِل إلى القائمة > واجهات برمجة التطبيقات والخدمات > شاشة موافقة OAuth.
- اختر نوع المستخدِم لتطبيقك، ثمّ انقر على إنشاء.
- أكمل نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.
في الوقت الحالي، يمكنك تخطي إضافة النطاقات والنقر على حفظ ومتابعة. في المستقبل، عند إنشاء تطبيق للاستخدام خارج مؤسستك على Google Workspace، عليك إضافة نطاقات التفويض التي يتطلبها تطبيقك والتحقّق منها.
- في حال اختيار خارجي لنوع المستخدم، أضِف مستخدمي الاختبار:
- ضمن المستخدمون التجريبيون، انقر على إضافة مستخدمين.
- أدخِل عنوان بريدك الإلكتروني وأي مستخدمين مختبِرين معتمدين آخرين، ثم انقر على حفظ ومتابعة.
- مراجعة ملخص تسجيل التطبيق. لإجراء تغييرات، انقر على تعديل. إذا كان تسجيل التطبيق يبدو على ما يرام، انقر على الرجوع إلى لوحة البيانات.
تفويض بيانات الاعتماد لتطبيق متوافق مع أجهزة سطح المكتب
للمصادقة بصفتك مستخدمًا نهائيًا والوصول إلى بيانات المستخدم في تطبيقك، عليك إنشاء معرّف عميل OAuth 2.0 واحد أو أكثر. يُستخدم معرّف العميل لتحديد تطبيق واحد لخوادم OAuth من Google. إذا كان تطبيقك يعمل على أنظمة أساسية متعددة، يجب إنشاء معرِّف عميل منفصل لكل نظام أساسي.- في وحدة تحكُّم Google Cloud، انتقِل إلى رمز القائمة > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
- انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
- انقر على نوع التطبيق > تطبيق سطح المكتب.
- في الحقل الاسم، اكتب اسمًا لبيانات الاعتماد. لا يظهر هذا الاسم إلا في Google Cloud Console.
- انقر على إنشاء. ستظهر شاشة إنشاء عميل OAuth وتعرض معرِّف العميل الجديد وسر العميل.
- انقر على حسنًا. تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن معرّفات عميل OAuth 2.0.
- احفظ ملف JSON الذي تم تنزيله بتنسيق
credentials.json
، وانقل الملف إلى دليل العمل.
تجهيز مساحة العمل
إنشاء دليل عمل:
mkdir quickstart
التغيير إلى دليل العمل:
cd quickstart
إعداد الوحدة الجديدة:
go mod init quickstart
يمكنك الحصول على مكتبة برامج Google Classroom API Go وحزمة OAuth2.0:
go get google.golang.org/api/classroom/v1 go get golang.org/x/oauth2/google
إعداد العيّنة
في دليل العمل، أنشئ ملفًا باسم
quickstart.go
.ألصق الرمز التالي في الملف:
تشغيل النموذج
في دليل العمل، أنشئ النموذج وشغِّله:
go run quickstart.go
-
في أول مرة تشغّل فيها النموذج، تطلب منك منح إذن الوصول:
- سجِّل الدخول إلى حسابك على Google إذا لم يسبق لك تسجيل الدخول. إذا كنت مسجّلاً الدخول إلى حسابات متعددة، اختَر حسابًا واحدًا لاستخدامه في عملية منح الإذن.
- انقر على قبول.
يتم تشغيل تطبيقك من Go ويستدعي واجهة برمجة تطبيقات Google Classroom API.
يتم تخزين معلومات التفويض في نظام الملفات، لذا لن يُطلب منك منح الإذن في المرة التالية التي تشغّل فيها نموذج الرمز.
الخطوات التالية
- تحديد مشاكل المصادقة والترخيص وحلّها
- مستندات مرجعية حول Classroom API
- قسم
google-api-go-client
في GitHub