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

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

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

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

الأهداف

  • ضبط البيئة
  • أنشِئ النص البرمجي وأعدّه.
  • شغِّل النص البرمجي.

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

  • مثيل لنطاق مورِّد Google
  • اتفاقية شركاء Google Workspace تم تنفيذها بالكامل

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

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

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

adminSDK/reseller/quickstart.gs
/**
 * List Admin SDK reseller.
 * @see https://developers.google.com/admin-sdk/reseller/reference/rest/v1/subscriptions/list
 */
function listSubscriptions() {
  const optionalArgs = {
    maxResults: 10,
  };
  if (!AdminReseller || !AdminReseller.Subscriptions) {
    throw new Error("Enable the AdminReseller Advanced Service.");
  }
  const response = AdminReseller.Subscriptions.list(optionalArgs);
  const subscriptions = response.subscriptions;
  if (!subscriptions || subscriptions.length === 0) {
    console.log("No subscriptions found.");
    return;
  }
  console.log("Subscriptions:");
  for (const subscription of subscriptions) {
    if (subscription.customerId && subscription.skuId) {
      if (subscription.plan?.planName) {
        console.log(
          "%s (%s, %s)",
          subscription.customerId,
          subscription.skuId,
          subscription.plan.planName,
        );
      } else {
        console.log("%s (%s)", subscription.customerId, subscription.skuId);
      }
    }
  }
}

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

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

تفعيل Reseller API

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

  1. انقر على أداة التعديل .
  2. بجانب الخدمات، انقر على "إضافة خدمة" .
  3. اختَر Google Workspace Reseller API وانقر على إضافة.

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

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

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

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

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

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