تفعيل واجهات برمجة التطبيقات في Google Workspace

قبل استخدام Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud. إذا لم يكن لديك مشروع على Google Cloud، يمكنك الاطّلاع على مقالة إنشاء مشروع على السحابة الإلكترونية.

لتفعيل واجهة برمجة تطبيقات في مشروعك على السحابة الإلكترونية:

Google Cloud Console

  1. في وحدة تحكّم Google Cloud، انتقِل إلى "القائمة" > واجهات برمجة التطبيقات والخدمات > المكتبة > Google Workspace.

    الانتقال إلى "مكتبة واجهة برمجة التطبيقات"

  2. انقر على واجهة برمجة التطبيقات التي تريد تفعيلها.
  3. انقر على تفعيل.
  4. لتفعيل المزيد من واجهات برمجة التطبيقات، كرِّر هذه الخطوات.

Google Cloud CLI

  1. ثبِّت واجهة سطر الأوامر (CLI) في Google Cloud أو افتحها.
  2. نفِّذ الأمر 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 في مشروعك على السحابة الإلكترونية.

تفعيل Admin SDK API
gcloud services enable admin.googleapis.com
تفعيل Alert Center API
gcloud services enable alertcenter.googleapis.com
تفعيل برمجة تطبيقات API
gcloud services enable script.googleapis.com
تفعيل CalDAV API
gcloud services enable caldav.googleapis.com
تفعيل Calendar API
gcloud services enable calendar-json.googleapis.com
تفعيل Chat API
gcloud services enable chat.googleapis.com
تفعيل Classroom API
gcloud services enable classroom.googleapis.com
تفعيل Cloud Identity API
gcloud services enable cloudidentity.googleapis.com
تفعيل Cloud Search API
gcloud services enable cloudsearch.googleapis.com
تفعيل Docs API
gcloud services enable docs.googleapis.com
تفعيل Drive API
gcloud services enable drive.googleapis.com
تفعيل Drive Activity API
gcloud services enable driveactivity.googleapis.com
تفعيل واجهة برمجة تطبيقات تصنيفات Drive
gcloud services enable drivelabels.googleapis.com
تفعيل واجهة برمجة تطبيقات "نماذج Google"
gcloud services enable forms.googleapis.com
تفعيل Gmail API
gcloud services enable gmail.googleapis.com
تفعيل Groups Migration API
gcloud services enable groupsmigration.googleapis.com
تفعيل واجهة برمجة تطبيقات إعدادات "مجموعات Google"
gcloud services enable groupssettings.googleapis.com
تفعيل Google Workspace add-ons API
gcloud services enable gsuiteaddons.googleapis.com
تفعيل Google Keep API
gcloud services enable keep.googleapis.com
تفعيل Enterprise License Manager API
gcloud services enable licensing.googleapis.com
تفعيل Marketplace API
gcloud services enable appsmarket.googleapis.com
تفعيل حزمة تطوير البرامج (SDK) في Marketplace
gcloud services enable appsmarket-component.googleapis.com
تفعيل Meet REST API
gcloud services enable meet.googleapis.com
تفعيل People API
gcloud services enable people.googleapis.com
تفعيل واجهة برمجة تطبيقات Postmaster Tools
gcloud services enable gmailpostmastertools.googleapis.com
تفعيل واجهة برمجة تطبيقات المورّد
gcloud services enable reseller.googleapis.com
تفعيل Sheets API
gcloud services enable sheets.googleapis.com
تفعيل واجهة برمجة تطبيقات "العروض التقديمية من Google"
gcloud services enable slides.googleapis.com
تفعيل Tasks API
gcloud services enable tasks.googleapis.com
تفعيل Vault API
gcloud services enable vault.googleapis.com

الخطوة التالية

تعرَّف على كيفية عمل المصادقة والتفويض لواجهات برمجة تطبيقات Google Workspace.