خدمة دليل SDK للمشرف

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

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

مَراجع

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

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

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

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

سرد جميع المستخدمين

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

Advanced/adminSDK.gs
/**
 * Lists all the users in a domain sorted by first name.
 * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list
 */
function listAllUsers() {
  let pageToken;
  let page;
  do {
    page = AdminDirectory.Users.list({
      domain: 'example.com',
      orderBy: 'givenName',
      maxResults: 100,
      pageToken: pageToken
    });
    const users = page.users;
    if (!users) {
      console.log('No users found.');
      return;
    }
    // Print the user's full name and email.
    for (const user of users) {
      console.log('%s (%s)', user.name.fullName, user.primaryEmail);
    }
    pageToken = page.nextPageToken;
  } while (pageToken);
}

الحصول على مستخدم

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

Advanced/adminSDK.gs
/**
 * Get a user by their email address and logs all of their data as a JSON string.
 * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/get
 */
function getUser() {
  // TODO (developer) - Replace userEmail value with yours
  const userEmail = 'liz@example.com';
  try {
    const user = AdminDirectory.Users.get(userEmail);
    console.log('User data:\n %s', JSON.stringify(user, null, 2));
  } catch (err) {
    // TODO (developer)- Handle exception from the API
    console.log('Failed with error %s', err.message);
  }
}

إضافة مستخدم

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

Advanced/adminSDK.gs
/**
 * Adds a new user to the domain, including only the required information. For
 * the full list of user fields, see the API's reference documentation:
 * @see https://developers.google.com/admin-sdk/directory/v1/reference/users/insert
 */
function addUser() {
  let user = {
    // TODO (developer) - Replace primaryEmail value with yours
    primaryEmail: 'liz@example.com',
    name: {
      givenName: 'Elizabeth',
      familyName: 'Smith'
    },
    // Generate a random password string.
    password: Math.random().toString(36)
  };
  try {
    user = AdminDirectory.Users.insert(user);
    console.log('User %s created with ID %s.', user.primaryEmail, user.id);
  } catch (err) {
    // TODO (developer)- Handle exception from the API
    console.log('Failed with error %s', err.message);
  }
}

إنشاء اسم مستعار

ينشئ هذا النموذج اسمًا مستعارًا (لقبًا) للمستخدم.

Advanced/adminSDK.gs
/**
 * Creates an alias (nickname) for a user.
 * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users.aliases/insert
 */
function createAlias() {
  // TODO (developer) - Replace userEmail value with yours
  const userEmail = 'liz@example.com';
  let alias = {
    alias: 'chica@example.com'
  };
  try {
    alias = AdminDirectory.Users.Aliases.insert(alias, userEmail);
    console.log('Created alias %s for user %s.', alias.alias, userEmail);
  } catch (err) {
    // TODO (developer)- Handle exception from the API
    console.log('Failed with error %s', err.message);
  }
}

سرد جميع المجموعات

يسرد هذا النموذج جميع المجموعات في النطاق.

Advanced/adminSDK.gs
/**
 * Lists all the groups in the domain.
 * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/groups/list
 */
function listAllGroups() {
  let pageToken;
  let page;
  do {
    page = AdminDirectory.Groups.list({
      domain: 'example.com',
      maxResults: 100,
      pageToken: pageToken
    });
    const groups = page.groups;
    if (!groups) {
      console.log('No groups found.');
      return;
    }
    // Print group name and email.
    for (const group of groups) {
      console.log('%s (%s)', group.name, group.email);
    }
    pageToken = page.nextPageToken;
  } while (pageToken);
}

إضافة عضو إلى المجموعة

يضيف هذا النموذج مستخدمًا إلى مجموعة حالية في النطاق.

Advanced/adminSDK.gs
/**
 * Adds a user to an existing group in the domain.
 * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/members/insert
 */
function addGroupMember() {
  // TODO (developer) - Replace userEmail value with yours
  const userEmail = 'liz@example.com';
  // TODO (developer) - Replace groupEmail value with yours
  const groupEmail = 'bookclub@example.com';
  const member = {
    email: userEmail,
    role: 'MEMBER'
  };
  try {
    AdminDirectory.Members.insert(member, groupEmail);
    console.log('User %s added as a member of group %s.', userEmail, groupEmail);
  } catch (err) {
    // TODO (developer)- Handle exception from the API
    console.log('Failed with error %s', err.message);
  }
}