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

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

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

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

الأهداف

  • أنشئ النص البرمجي.
  • تفعيل واجهة برمجة تطبيقات "تقويم Google"
  • نفِّذ النموذج.

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

  • حساب Google مع تفعيل "تقويم Google".

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

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

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

calendar/quickstart/quickstart.gs
/**
 * Lists 10 upcoming events in the user's calendar.
 * @see https://developers.google.com/calendar/api/v3/reference/events/list
 */
function listUpcomingEvents() {
  const calendarId = 'primary';
  // Add query parameters in optionalArgs
  const optionalArgs = {
    timeMin: (new Date()).toISOString(),
    showDeleted: false,
    singleEvents: true,
    maxResults: 10,
    orderBy: 'startTime'
    // use other optional query parameter here as needed.
  };
  try {
    // call Events.list method to list the calendar events using calendarId optional query parameter
    const response = Calendar.Events.list(calendarId, optionalArgs);
    const events = response.items;
    if (events.length === 0) {
      console.log('No upcoming events found');
      return;
    }
    // Print the calendar events
    for (const event of events) {
      let when = event.start.dateTime;
      if (!when) {
        when = event.start.date;
      }
      console.log('%s (%s)', event.summary, when);
    }
  } catch (err) {
    // TODO (developer) - Handle exception from Calendar API
    console.log('Failed with error %s', err.message);
  }
}

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

تفعيل Google Calendar API

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

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

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

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

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

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

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