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

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

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

مراجع

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

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

رمز نموذجي

يستخدم نموذج التعليمات البرمجية التالي الإصدار 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);
  }
}