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

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

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

في "برمجة تطبيقات Google"، تستخدم أدلة البدء السريع في 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

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

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

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

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

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

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

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

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