خدمة إدارة تراخيص Admin SDK Enterprise

في برمجة تطبيقات لمنح تراخيص المستخدمين وتعديلها واستردادها وحذفها

تتيح لك خدمة "إدارة تراخيص Enterprise" في SDK للمشرف استخدام واجهة برمجة تطبيقات "إدارة تراخيص Enterprise" في SDK للمشرف في برمجة تطبيقات Google. تتيح واجهة برمجة التطبيقات هذه لمشرفي النطاق تخصيص تراخيص المستخدمين وتعديلها واستردادها وحذفها.

هذه خدمة متقدّمة يجب تفعيلها قبل الاستخدام.

مراجع

للحصول على معلومات تفصيلية عن هذه الخدمة، يُرجى الاطّلاع على المستندات المرجعية الخاصة بـ Admin SDK Enterprise License Manager API. مثل جميع الخدمات المتقدّمة في Apps Script، تستخدم خدمة "إدارة تراخيص Enterprise" في Admin SDK العناصر والطرق والمعلَمات نفسها التي تستخدمها واجهة برمجة التطبيقات العامة. لمزيد من المعلومات، اطّلِع على كيفية تحديد التواقيع.

للإبلاغ عن المشاكل والعثور على دعم آخر، يُرجى الاطّلاع على دليل دعم "مدير تراخيص Admin SDK Enterprise".

نموذج التعليمات البرمجية

يستخدم نموذج الرمز البرمجي التالي الإصدار 1 من واجهة برمجة التطبيقات.

الحصول على قائمة بتراخيص النطاق

تسجّل هذه العيّنة عمليات منح التراخيص، بما في ذلك معرّف المنتج ومعرّف رمز التخزين التعريفي، للمستخدمين في النطاق. لاحظ استخدام رموز الصفحات للوصول إلى القائمة الكاملة بالنتائج.

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,
    );
  }
}

إدراج مهمة منح ترخيص لمستخدم

يوضّح هذا النموذج كيفية إدراج عملية منح ترخيص لمستخدم، وذلك باستخدام مجموعة من رقم تعريف المنتج ورمز التخزين التعريفي.

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);
  }
}