خدمة إعدادات مجموعات حزمة تطوير البرامج (SDK) للمشرف

‫Apps Script لإدارة إعدادات المجموعات لنطاقات Google Workspace

تتيح لك خدمة "إعدادات المجموعات" في حزمة تطوير البرامج (SDK) للمشرف استخدام Groups Settings API في برمجة تطبيقات Google. تتيح واجهة برمجة التطبيقات هذه لمشرفي نطاقات Google Workspace (بما في ذلك المورّدون) إمكانية إدارة إعدادات المجموعات في حساباتهم على Google Workspace.

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

مراجع

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

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

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

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

الحصول على إعدادات مجموعة

يحصل هذا النموذج على إعدادات المجموعة ويسجّلها في وحدة التحكّم.

advanced/adminSDK.gs
/**
 * Gets a group's settings and logs them to the console.
 */
function getGroupSettings() {
  // TODO (developer) - Replace groupId value with yours
  const groupId = "exampleGroup@example.com";
  try {
    const group = AdminGroupsSettings.Groups.get(groupId);
    console.log(JSON.stringify(group, null, 2));
  } catch (err) {
    // TODO (developer)- Handle exception from the API
    console.log("Failed with error %s", err.message);
  }
}

تعديل إعدادات مجموعة

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

advanced/adminSDK.gs
/**
 * Updates group's settings. Here, the description is modified, but various
 * other settings can be changed in the same way.
 * @see https://developers.google.com/admin-sdk/groups-settings/v1/reference/groups/patch
 */
function updateGroupSettings() {
  const groupId = "exampleGroup@example.com";
  try {
    const group = AdminGroupsSettings.newGroups();
    group.description = "Newly changed group description";
    AdminGroupsSettings.Groups.patch(group, groupId);
  } catch (err) {
    // TODO (developer)- Handle exception from the API
    console.log("Failed with error %s", err.message);
  }
}