دليل سريع للبدء في Google Apps Script

أنشئ نصًا برمجيًا في برمجة تطبيقات Google يرسل طلبات إلى مدير SDK API.

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

في "برمجة تطبيقات Google"، تستخدم أدلة البدء السريع في Google Workspace خدمات Google المتقدّمة لاستدعاء Google Workspace APIs والتعامل مع بعض تفاصيل عملية المصادقة والتفويض.

الأهداف

  • ضبط البيئة
  • إنشاء النص البرمجي وضبطه
  • تشغيل النص البرمجي

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

  • نطاق Google Workspace تم تفعيل إمكانية الوصول إلى واجهة برمجة التطبيقات فيه .
  • حساب Google في هذا النطاق لديه امتيازات المشرف

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

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

  1. أنشئ نصًا برمجيًا جديدًا في أداة تعديل النصوص البرمجية في برمجة تطبيقات Google من خلال الانتقال إلى 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,
  };
  if (!AdminReports || !AdminReports.Activities) {
    throw new Error("Enable the AdminReports Advanced Service.");
  }
  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) {
    if (
      activity.id?.time &&
      activity.actor?.email &&
      activity.events?.[0]?.name
    ) {
      console.log(
        "%s: %s (%s)",
        activity.id.time,
        activity.actor.email,
        activity.events[0].name,
      );
    }
  }
}

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

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

تفعيل Admin SDK API

افتح مشروع "برمجة تطبيقات Google".

  1. انقر على المحرِّر .
  2. بجانب الخدمات، انقر على "إضافة خدمة" .
  3. اختَر Admin SDK API وانقر على إضافة.

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

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

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

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

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

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