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

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

مراجع

للحصول على معلومات تفصيلية حول هذه الخدمة، يُرجى الاطّلاع على المستندات المرجعية الخاصة بواجهة برمجة التطبيقات Admin SDK Groups Settings API. مثل جميع الخدمات المتقدّمة في Apps Script، تستخدم خدمة إعدادات "مجموعات Google" في 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);
  }
}