מדריך למתחילים ב-Google Apps Script

יוצרים סקריפט של Google Apps ששולח בקשות ל-Reseller API.

במדריכים אחרים למתחילים מוסבר איך להגדיר ולהריץ אפליקציה שקוראת ל-Google Workspace API. במדריך הנוכחי נשתמש בגישה פשוטה לאימות, שמתאימה לסביבת בדיקה. בסביבת ייצור, אנחנו ממליצים לכם לקרוא על אימות והרשאה לפני שאתם בוחרים את פרטי הגישה שמתאימים לאפליקציה שלכם.

במדריכים למתחילים של Google Workspace ב-Apps Script נעשה שימוש בשירותים מתקדמים של Google כדי לקרוא ל-Google Workspace APIs ולטפל בחלק מהפרטים של תהליך האימות וההרשאה.

מטרות

  • מגדירים את הסביבה.
  • יוצרים ומגדירים את הסקריפט.
  • מריצים את הסקריפט.

דרישות מוקדמות

  • מופע של דומיין של מפיץ Google.
  • הסכם שותפים של Google Workspace שנחתם באופן מלא.

  • גישה ל-Google Drive

יצירת הסקריפט

  1. יוצרים סקריפט חדש בעורך Apps Script בכתובת 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. לוחצים על Untitled project, מקלידים Quickstart ולוחצים על Rename.

הגדרת הסקריפט

הפעלת Reseller API

פותחים את פרויקט Apps Script.

  1. לוחצים על עריכה .
  2. לצד שירותים, לוחצים על סמל הוספת שירות .
  3. בוחרים באפשרות Google Workspace Reseller API ולוחצים על הוספה.

מריצים את הדוגמה

בעורך Apps Script, לוחצים על Run (הפעלה).

בפעם הראשונה שמריצים את הדוגמה, מוצגת בקשה לאשר את הגישה:

  1. לוחצים על בדיקת הרשאות.
  2. בוחרים חשבון.
  3. לוחצים על אישור.

יומן ההפעלה של הסקריפט מופיע בתחתית החלון.

השלבים הבאים