تشرح مبادئ التشغيل السريعة كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة التطبيقات في Google Workspace.
تستخدم الشركات الناشئة في Google Workspace مكتبات عملاء واجهة برمجة التطبيقات للتعامل مع بعض تفاصيل عملية المصادقة والترخيص. ننصح بما يلي: استخدام مكتبات البرامج لتطبيقاتك الخاصة. تستخدم هذه البدء السريع وهو نهج مصادقة مبسط مناسب للاختبار محددة. بالنسبة إلى بيئة الإنتاج، ننصحك بالاطّلاع على المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول المناسبة لتطبيقك.
أنشئ تطبيق سطر أوامر Go لإجراء طلبات إلى واجهة برمجة تطبيقات "مستندات Google"
الأهداف
- إعداد البيئة.
- إعداد العيّنة
- نفِّذ النموذج.
المتطلبات الأساسية
- أحدث إصدار من Go (انتقال).
- أحدث إصدار من Git
- مشروع على Google Cloud:
- حساب Google
إعداد البيئة
لإكمال هذا البدء السريع، عليك إعداد البيئة الخاصة بك.
تفعيل واجهة برمجة التطبيقات
قبل استخدام Google APIs، يجب تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في وحدة تحكُّم Google Cloud، فعِّل Google Docs 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
، وانقل إلى دليل العمل.
تجهيز مساحة العمل
إنشاء دليل عامل:
mkdir quickstart
التغيير إلى دليل العمل:
cd quickstart
تهيئة الوحدة الجديدة:
go mod init quickstart
الحصول على مكتبة برامج Google Docs API Go وحزمة OAuth2.0:
go get google.golang.org/api/docs/v1 go get golang.org/x/oauth2/google
إعداد العيّنة
في دليل العمل، أنشِئ ملفًا باسم "
quickstart.go
".في الملف، الصق التعليمة البرمجية التالية:
تنفيذ النموذج
في دليل العمل، أنشئ النموذج وشغِّله:
go run quickstart.go
-
عند تشغيل النموذج لأول مرة، يطالبك بتفويض الوصول:
- إذا لم تكن مسجِّلاً الدخول إلى حسابك على Google، سجِّل الدخول عندما يُطلب منك ذلك. في حال حذف سجّلت الدخول إلى حسابات متعددة، اختَر حسابًا واحدًا لاستخدامه في عملية التفويض.
- انقر على قبول.
يتم تشغيل تطبيق Go واستدعاء واجهة برمجة تطبيقات مستندات Google.
يتم تخزين معلومات التفويض في نظام الملفات، لذا عندما تقوم بتشغيل النموذج في المرة التالية الرمز، فلن يُطلب منك منح الإذن.
الخطوات التالية
- تحديد مشاكل المصادقة والترخيص وحلّها
- المستندات المرجعية لواجهة برمجة التطبيقات في "مستندات Google"
- القسم
google-api-go-client
في GitHub