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

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

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

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

الأهداف

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

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

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

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

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

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

/**
 * 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);
  }
}

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

تفعيل Google Calendar API

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

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

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

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

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

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

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

• مستندات الخدمات المتقدّمة لبرمجة تطبيقات Google
• إنشاء أحداث
• تحديد مشاكل المصادقة والترخيص وحلّها
• المستندات المرجعية لواجهة برمجة التطبيقات Calendar API