המדריך למתחילים של Google Apps Script

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

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

לכתוב Google Apps Script ששולח בקשות לממשק ה-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. לוחצים על פרויקט ללא שם, מקלידים מדריך למתחילים, ולוחצים על שינוי שם.

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

הפעלת המפיצים באמצעות ממשק API

  1. פותחים את פרויקט Apps Script.
  1. לוחצים על עריכה .
  2. לצד שירותים לוחצים על 'הוספת שירות'. .
  3. יש לבחור באחת מהאפשרויות הבאות ממשק API של Enterprise Apps למפיצים ולוחצים על Add.

הרצת הדוגמה

בעורך Apps Script, לוחצים על Run.

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

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

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

השלבים הבאים