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

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

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

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

الأهداف

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

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

  • نسخة من نطاق مورِّد Google
  • اتفاقية شريك Google Workspace مُنفَّذة بالكامل

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

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

  1. أنشئ نصًا برمجيًا جديدًا من خلال الانتقال إلى 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
  };
  try {
    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) {
      console.log('%s (%s, %s)', subscription.customerId, subscription.skuId,
          subscription.plan.planName);
    }
  } catch (err) {
    // TODO (developer)- Handle exception from the Reseller  API
    console.log('Failed with error %s', err.message);
  }
}

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

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

تفعيل Reseller API

  1. افتح مشروع Apps Script.
  1. انقر على رمز أداة التعديل .
  2. بجانب الخدمات، انقر على "إضافة خدمة" .
  3. اختَر Enterprise Apps Reseller API وانقر على إضافة.

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

في محرِّر Apps Script، انقر على تشغيل.

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

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

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

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