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

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

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

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

الأهداف

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

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

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

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

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

افتح مشروع Cloud الذي تريد استخدامه لهذه العيّنة إذا لم يكن مفتوحًا من قبل:

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

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

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

تفعيل Chat API

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

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

  2. في حقل نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
  3. املأ نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.

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

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

ضبط تطبيق Google Chat

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

  1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة ضبط 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. انقر على مشروع بلا عنوان، واكتب البدء السريع، ثم انقر على إعادة التسمية.

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

نسخ رقم مشروع Cloud

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

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

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

تفعيل Google Chat API

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

الدردشة/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"
    }]
  }
}

تشغيل العيّنة

في محرِّر Apps Script، انقر على تشغيل.

في المرة الأولى التي تُشغِّل فيها العيّنة، سيُطلب منك تفويض الوصول:

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

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

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