البدء السريع لبرمجة تطبيقات Google

تشرح مبادئ التشغيل السريعة كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة التطبيقات في Google Workspace.

تستخدم الشركات الناشئة في Google Workspace مكتبات عملاء واجهة برمجة التطبيقات للتعامل مع بعض تفاصيل عملية المصادقة والترخيص. ننصح بما يلي: استخدام مكتبات البرامج لتطبيقاتك الخاصة. تستخدم هذه البدء السريع وهو نهج مصادقة مبسَّط مناسب للاختبار محددة. بالنسبة إلى بيئة الإنتاج، ننصحك بالاطّلاع على المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول المناسبة لتطبيقك.

إنشاء برمجة تطبيقات Google التي ترسل طلبات إلى Google Chat API.

الأهداف

  • اضبط البيئة.
  • أنشئ النص البرمجي واضبطه.
  • شغِّل النص البرمجي.

المتطلبات الأساسية

ضبط إعدادات مشروعك على Google Cloud

في حال استخدام مشروع جديد على Google Cloud لإكمال هذه البداية السريعة، عليك إجراء ما يلي: وتهيئته وإضافة نفسك كمستخدم تجريبي. إذا كنت قد قمت بالفعل هذه الخطوات لمشروعك على السحابة الإلكترونية، انتقِل إلى القسم التالي.

فتح مشروعك على Google Cloud في "وحدة تحكُّم Google Cloud"

افتح المشروع على Google Cloud الذي تريد استخدامه إذا لم يكن مفتوحًا. لهذا النموذج:

  1. في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة اختيار مشروع.

    اختيار مشروع على Google Cloud

  2. اختَر المشروع على Google Cloud الذي تريد استخدامه. أو انقر على إنشاء مشروع واتّبِع التعليمات الظاهرة على الشاشة. في حال إنشاء مشروع على Google Cloud، قد تحتاج إلى تفعيل الفوترة للمشروع.

تفعيل Chat API

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

    الانتقال إلى شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

  2. بالنسبة إلى نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
  3. أكمِل نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.
  4. في الوقت الحالي، يمكنك تخطّي إضافة النطاقات والنقر على حفظ ومتابعة. في المستقبل، عند إنشاء تطبيق للاستخدام خارج Google Workspace، عليك تغيير نوع المستخدم إلى خارجي، وبعد ذلك أضِف نطاقات الأذونات التي يتطلبها تطبيقك.

  5. مراجعة ملخّص تسجيل التطبيق لإجراء تغييرات، انقر على تعديل. إذا كان التطبيق التسجيل يبدو على ما يرام، انقر على الرجوع إلى لوحة التحكم.

ضبط تطبيق Google Chat

لاستدعاء Google Chat API، يجب ضبط تطبيق Google Chat بالنسبة إلى أي طلبات كتابة، يمكن لتطبيق Google Chat تطبيق Google Chat في واجهة المستخدم باستخدام المعلومات التالية.

  1. في Google Cloud Console، انتقِل إلى صفحة ضبط واجهة Chat API:

    الانتقال إلى صفحة إعدادات Chat API

  2. ضمن معلومات التطبيق، أدخِل المعلومات التالية:

    1. في الحقل اسم التطبيق، أدخِل Chat API quickstart app.
    2. في حقل عنوان URL للصورة الرمزية، أدخل https://developers.google.com/chat/images/quickstart-app-avatar.png
    3. في حقل الوصف، أدخِل Quickstart for calling the Chat API.
  3. ضمن الميزات التفاعلية، انقر على تفعيل الميزات التفاعلية. لإيقاف الميزات التفاعلية تطبيق Chat

  4. انقر على حفظ.

إنشاء النص البرمجي

  1. أنشِئ نصًا برمجيًا جديدًا من خلال الانتقال إلى script.google.com/create.
  2. استبدل محتوى محرر النصوص البرمجية بالرمز التالي:

chat/quickstart/Code.gs
/**
 * This quickstart sample shows how to list spaces with user credential
 *
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.spaces.readonly'
 * referenced in the manifest file (appsscript.json).
 */
function listSpaces() {
  // Initialize request argument(s)
  // Filter spaces by space type (SPACE or GROUP_CHAT or DIRECT_MESSAGE)
  const filter = 'space_type = "SPACE"';

  // Iterate through the response pages using page tokens
  let responsePage;
  let pageToken = null;
  do {
    // Request response pages
    responsePage = Chat.Spaces.list({
      filter: filter,
      pageToken: pageToken
    });
    // Handle response pages
    if (responsePage.spaces) {
      responsePage.spaces.forEach((space) => console.log(space));
    }
    // Update the page token to the next one
    pageToken = responsePage.nextPageToken;
  } while (pageToken);
}

  1. انقر على "حفظ" .
  2. انقر على مشروع بلا عنوان، واكتب التشغيل السريع، والنقر على إعادة تسمية

ضبط النص البرمجي

نسخ رقم المشروع على Google Cloud

  1. في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة . > إدارة الهوية وإمكانية الوصول و المشرف > الإعدادات.

    الانتقال إلى "إدارة الهوية وإمكانية الوصول" إعدادات المشرف

  2. في حقل رقم المشروع، انسخ القيمة.
  1. افتح مشروع "برمجة تطبيقات Google".
  2. انقر على رمز إعدادات المشروع .
  3. ضمن مشروع Google Cloud Platform (GCP)، انقر على تغيير المشروع.
  4. في رقم مشروع Google Cloud Platform، الصِق رقم مشروع Google Cloud.
  5. انقر على ضبط المشروع.

تفعيل Google Chat API

  1. افتح مشروع "برمجة تطبيقات Google".
  1. انقر على رمز إعدادات المشروع .
  2. ضمن الإعدادات العامة، فعِّل الخيار عرض "appsscript.json" ملف البيان في المحرِّر.
  3. انقر على رمز المحرِّر ، ثم اختَر الملف appscript.json، واستبدل المحتويات بالتعليمة البرمجية التالية:

chat/quickstart/appsscript.json
{
  "timeZone": "America/New_York",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.spaces.readonly"
  ],
  "chat": {},
  "dependencies": {
    "enabledAdvancedServices": [{
      "userSymbol": "Chat",
      "version": "v1",
      "serviceId": "chat"
    }]
  }
}

تنفيذ النموذج

في محرِّر "برمجة تطبيقات Google"، انقر على تشغيل.

عند تشغيل النموذج لأول مرة، يطالبك بتفويض الوصول:

  1. انقر على مراجعة الأذونات.
  2. اختر حسابًا.
  3. انقر على سماح.

يظهر سجلّ تنفيذ النص البرمجي في أسفل النافذة.

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