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

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

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

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

מטרות

  • יוצרים את הסקריפט.
  • להפעיל את Seller 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.
  2. לוחצים על עריכה .
  3. ליד שירותים, לוחצים על 'הוספת שירות' .
  4. בוחרים באפשרות Enterprise Apps Seller API ולוחצים על Add.

הרצת הדוגמה

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

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

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

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

השלבים הבאים