שירות Admin SDK Enterprise License Manager

ב-Apps Script כדי להקצות, לעדכן, לאחזר ולמחוק רישיונות משתמשים.

שירות Enterprise License Manager של Admin SDK מאפשר לכם להשתמש ב-Admin SDK Enterprise License Manager API ב-Google Apps Script. ממשק ה-API הזה מאפשר לאדמינים של דומיין להקצות, לעדכן, לאחזר ולמחוק רישיונות משתמשים.

זהו שירות מתקדם שצריך להפעיל לפני השימוש.

חומרי עזר

מידע מפורט על השירות הזה זמין במאמרי העזרה בנושא Admin SDK Enterprise License Manager API. בדומה לכל השירותים המתקדמים ב-Apps Script, שירות Admin SDK Enterprise License Manager משתמש באותם אובייקטים, שיטות ופרמטרים כמו ממשק ה-API הציבורי. מידע נוסף זמין במאמר איך נקבעות חתימות של שיטות.

כדי לדווח על בעיות ולקבל תמיכה אחרת, אפשר לעיין במדריך התמיכה של Admin SDK Enterprise License Manager.

קוד לדוגמה

בדוגמת הקוד הבאה נעשה שימוש בגרסה 1 של ה-API.

קבלת רשימה של הקצאות רישיונות לדומיין

בדוגמה הזו מתועדות הקצאות הרישיונות, כולל מזהה המוצר ומזהה המק"ט, למשתמשים בדומיין. שימו לב לשימוש באסימוני דפים כדי לגשת לרשימת התוצאות המלאה.

advanced/adminSDK.gs
/**
 * Logs the license assignments, including the product ID and the sku ID, for
 * the users in the domain. Notice the use of page tokens to access the full
 * list of results.
 */
function getLicenseAssignments() {
  const productId = "Google-Apps";
  const customerId = "example.com";
  let assignments = [];
  let pageToken = null;
  do {
    const response = AdminLicenseManager.LicenseAssignments.listForProduct(
      productId,
      customerId,
      {
        maxResults: 500,
        pageToken: pageToken,
      },
    );
    assignments = assignments.concat(response.items);
    pageToken = response.nextPageToken;
  } while (pageToken);
  // Print the productId and skuId
  for (const assignment of assignments) {
    console.log(
      "userId: %s, productId: %s, skuId: %s",
      assignment.userId,
      assignment.productId,
      assignment.skuId,
    );
  }
}

הוספת הקצאת רישיון למשתמש

בדוגמה הזו אפשר לראות איך להוסיף הקצאת רישיון למשתמש, עבור שילוב נתון של מזהה מוצר ומזהה SKU.

advanced/adminSDK.gs
/**
 * Insert a license assignment for a user, for a given product ID and sku ID
 * combination.
 * For more details follow the link
 * https://developers.google.com/admin-sdk/licensing/reference/rest/v1/licenseAssignments/insert
 */
function insertLicenseAssignment() {
  const productId = "Google-Apps";
  const skuId = "Google-Vault";
  const userId = "marty@hoverboard.net";
  try {
    const results = AdminLicenseManager.LicenseAssignments.insert(
      { userId: userId },
      productId,
      skuId,
    );
    console.log(results);
  } catch (e) {
    // TODO (developer) - Handle exception.
    console.log("Failed with an error %s ", e.message);
  }
}