التشغيل السريع لبرمجة Google Apps

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

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

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

الأهداف

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

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

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

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

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

adminSDK/reports/quickstart.gs
/**
 * List login events for a Google Workspace domain.
 * @see https://developers.google.com/admin-sdk/reports/reference/rest/v1/activities/list
 */
function listLogins() {
  const userKey = 'all';
  const applicationName = 'login';
  const optionalArgs = {
    maxResults: 10
  };
  try {
    const response = AdminReports.Activities.list(userKey, applicationName, optionalArgs);
    const activities = response.items;
    if (!activities || activities.length === 0) {
      console.log('No logins found.');
      return;
    }
    // Print login events
    console.log('Logins:');
    for (const activity of activities) {
      console.log('%s: %s (%s)', activity.id.time, activity.actor.email,
          activity.events[0].name);
    }
  } catch (err) {
    // TODO (developer)- Handle exception from the Report  API
    console.log('Failed with error %s', err.message);
  }
}

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

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

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

تشغيل النموذج

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

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

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

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

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