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

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

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

أنشئ برمجة تطبيقات Google لإجراء طلبات إلى واجهة برمجة التطبيقات Gmail API.

الأهداف

  • أنشئ النص البرمجي.
  • فعِّل Gmail API.
  • شغِّل النموذج.

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

  • حساب Google مع تفعيل Gmail.

  • الوصول إلى Google Drive

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

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

gmail/quickstart/quickstart.gs
/**
 * Lists all labels in the user's mailbox
 * @see https://developers.google.com/gmail/api/reference/rest/v1/users.labels/list
 */
function listLabels() {
  try {
    // Gmail.Users.Labels.list() API returns the list of all Labels in user's mailbox
    const response = Gmail.Users.Labels.list('me');
    if (!response || response.labels.length === 0) {
      // TODO (developer) - No labels are returned from the response
      console.log('No labels found.');
      return;
    }
    // Print the Labels that are available.
    console.log('Labels:');
    for (const label of response.labels ) {
      console.log('- %s', label.name);
    }
  } catch (err) {
    // TODO (developer) - Handle exception on Labels.list() API
    console.log('Labels.list() API failed with error %s', err.toString());
  }
}

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

تفعيل واجهة برمجة التطبيقات Gmail API

  1. افتح مشروع "برمجة تطبيقات Google".
  2. انقر على محرِّر .
  3. بجانب الخدمات، انقر على "إضافة خدمة" .
  4. اختَر Gmail API وانقر على إضافة.

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

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

في المرة الأولى التي تشغّل فيها النموذج، يُطلب منك منح إذن الوصول:

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

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

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