قبل استخدام Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud. إذا لم يكن لديك مشروع على Google Cloud، يمكنك الاطّلاع على مقالة إنشاء مشروع على السحابة الإلكترونية.
لتفعيل واجهة برمجة تطبيقات في مشروعك على السحابة الإلكترونية:
Google Cloud Console
- في وحدة تحكّم Google Cloud، انتقِل إلى "القائمة" > واجهات برمجة التطبيقات والخدمات > المكتبة > Google Workspace.
- انقر على واجهة برمجة التطبيقات التي تريد تفعيلها.
- انقر على تفعيل.
- لتفعيل المزيد من واجهات برمجة التطبيقات، كرِّر هذه الخطوات.
Google Cloud CLI
- ثبِّت واجهة سطر الأوامر (CLI) في Google Cloud أو افتحها.
-
نفِّذ الأمر
services enableمع تحديد خدمة واجهة برمجة التطبيقات التي تريد تفعيلها.gcloud services enable API_SERVICE_ID
واجهات برمجة التطبيقات المفعَّلة مسبقًا في Google AI Studio
عند إنشاء تطبيقات ويب في Google AI Studio، ليس عليك تفعيل واجهات برمجة تطبيقات Google Workspace المتوافقة يدويًا في Google Cloud Console. تكون واجهات برمجة التطبيقات التالية مفعَّلة مسبقًا في مشروعك على Starter Tier الذي تديره Google:
- تقويم Google API (
calendar-json.googleapis.com) - Google Docs API (
docs.googleapis.com) - Google Drive API (
drive.googleapis.com) - Google Forms API (
forms.googleapis.com) - Gmail API (
gmail.googleapis.com) - Google Picker API (
picker.googleapis.com) - Google Sheets API (
sheets.googleapis.com) - Google Slides API (
slides.googleapis.com) - Google Tasks API (
tasks.googleapis.com)
في مشروع من المستوى الأساسي، تتيح واجهات برمجة تطبيقات Google Workspace استخدام OAuth 2.0 من جهة العميل فقط. على سبيل المثال، تستخدم Google Picker API رموز الوصول المميزة لبروتوكول OAuth 2.0 بدلاً من مفتاح واجهة برمجة التطبيقات للمطوّر، ولا تتوفّر حسابات الخدمة أو تخزين أسرار عملاء OAuth في Secret Manager. إذا كنت بحاجة إلى بيانات اعتماد من جهة الخادم أو مفاتيح واجهة برمجة التطبيقات أو واجهات برمجة تطبيقات إضافية، مثل واجهة برمجة تطبيقات "مدير SDK" أو واجهة برمجة تطبيقات "برمجة تطبيقات Google"، يمكنك ترقية مشروعك من "الفئة المبتدئة" إلى مشروع عادي على السحابة الإلكترونية وضبطها يدويًا.
لمعرفة التفاصيل حول حصص وميزات Starter Tier، يُرجى الاطّلاع على نظرة عامة على Starter Tier ونشر تطبيقات الويب من Google AI Studio.
(اختياري) تجربة واجهات برمجة تطبيقات Google Workspace في التطبيقات التجريبية
إذا كنت تجرّب Google Workspace، استخدِم الاختصار التالي الذي يتيح واجهات برمجة تطبيقات Google Workspace الشائعة وينشئ بيانات اعتماد OAuth التي يمكنك استخدامها.
إذا كنت تطوّر تطبيقًا يصل إلى معلومات المستخدمين، عليك ضبط شاشة طلب الموافقة عبر OAuth قبل إصدار تطبيقك.
انقر على هذا الزر لاختيار مشروع على Google Cloud أو إنشائه، وتفعيل واجهات برمجة تطبيقات Workspace تلقائيًا:
تفعيل واجهات برمجة تطبيقات Workspace
في مربّع الحوار الذي يظهر، انقر على تنزيل إعدادات العميل واحفظcredentials.json في دليل العمل.
يمكنك الاطّلاع على مستكشف واجهات برمجة تطبيقات Google Workspace للحصول على قائمة شاملة بجميع واجهات برمجة التطبيقات المتاحة، ولتجربة طرق معيّنة من متصفّحك.
واجهات برمجة التطبيقات المفعَّلة (انقر للتوسيع)
يؤدي النقر على الزر إلى تفعيل واجهات برمجة التطبيقات التالية:
- Admin SDK API
- واجهة برمجة التطبيقات لبرمجة التطبيقات
- Calendar API
- واجهة برمجة التطبيقات للدردشة
- Classroom API
- Docs API
- واجهة برمجة تطبيقات Drive
- Forms API
- Gmail API
- Google Workspace add-ons API
- واجهة برمجة تطبيقات Google Keep
- Meet REST API
- Sheets API
- Slides API
واجهات برمجة التطبيقات في Google Workspace
استخدِم روابط وحدة تحكّم Google Cloud التالية أو واجهة سطر أوامر Google Cloud (CLI) لتفعيل واجهات برمجة تطبيقات معيّنة في Google Workspace في مشروعك على السحابة الإلكترونية.
واجهة برمجة التطبيقات SDK للمشرف |
تفعيل Admin SDK API
|
Alert Center API |
تفعيل Alert Center API
|
Apps Script API |
تفعيل برمجة تطبيقات API
|
CalDAV API |
تفعيل CalDAV API
|
Calendar API |
تفعيل Calendar API
|
Chat API |
تفعيل Chat API
|
Classroom API |
تفعيل Classroom API
|
Cloud Identity API |
تفعيل Cloud Identity API
|
واجهة برمجة تطبيقات Cloud Search |
تفعيل Cloud Search API
|
Docs API |
تفعيل Docs API
|
Drive API |
تفعيل Drive API
|
Drive Activity API |
تفعيل Drive Activity API
|
واجهة برمجة تطبيقات تصنيفات Drive |
تفعيل واجهة برمجة تطبيقات تصنيفات Drive
|
Forms API |
تفعيل واجهة برمجة تطبيقات "نماذج Google"
|
Gmail API |
تفعيل Gmail API
|
Groups Migration API |
تفعيل Groups Migration API
|
Groups Settings API |
تفعيل واجهة برمجة تطبيقات إعدادات "مجموعات Google"
|
Google Workspace add-ons API |
تفعيل Google Workspace add-ons API
|
Google Keep API |
تفعيل Google Keep API
|
Enterprise License Manager API |
تفعيل Enterprise License Manager API
|
Marketplace API |
تفعيل Marketplace API
|
حزمة تطوير البرامج (SDK) في Marketplace |
تفعيل حزمة تطوير البرامج (SDK) في Marketplace
|
Meet REST API |
تفعيل Meet REST API
|
People API |
تفعيل People API
|
واجهة برمجة تطبيقات Postmaster Tools |
تفعيل واجهة برمجة تطبيقات Postmaster Tools
|
واجهة برمجة تطبيقات المورّد |
تفعيل واجهة برمجة تطبيقات المورّد
|
Sheets API |
تفعيل Sheets API
|
Slides API |
تفعيل واجهة برمجة تطبيقات "العروض التقديمية من Google"
|
Tasks API |
تفعيل Tasks API
|
Vault API |
تفعيل Vault API
|
الخطوة التالية
تعرَّف على كيفية عمل المصادقة والتفويض لواجهات برمجة تطبيقات Google Workspace.