البدء السريع لبرمجة تطبيقات Google

تشرح أدلة البدء السريع كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة تطبيقات Google Workspace.

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

أنشئ برمجة تطبيقات Google لإرسال طلبات إلى Directory API.

الأهداف

  • أنشِئ النص البرمجي.
  • تفعيل Directory API.
  • شغِّل العيّنة.

المتطلبات الأساسية

  • الوصول إلى Google Drive

إنشاء النص البرمجي

  1. أنشِئ نصًا برمجيًا جديدًا بالانتقال إلى script.google.com/create.
  2. استبدل محتويات محرر النصوص البرمجية بالرمز التالي:

adminSDK/directory/quickstart.gs
/**
 * Lists users in a Google Workspace domain.
 * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list
 */
function listUsers() {
  const optionalArgs = {
    customer: 'my_customer',
    maxResults: 10,
    orderBy: 'email'
  };
  try {
    const response = AdminDirectory.Users.list(optionalArgs);
    const users = response.users;
    if (!users || users.length === 0) {
      console.log('No users found.');
      return;
    }
    // Print the list of user's full name and email
    console.log('Users:');
    for (const user of users) {
      console.log('%s (%s)', user.primaryEmail, user.name.fullName);
    }
  } catch (err) {
    // TODO (developer)- Handle exception from the Directory API
    console.log('Failed with error %s', err.message);
  }
}

  1. انقر على "حفظ" .
  2. انقر على مشروع بلا عنوان، واكتب البدء السريع، ثم انقر على إعادة تسمية.

تفعيل Directory API

  1. افتح مشروع "برمجة تطبيقات Google".
  2. انقر على رمز أداة التعديل .
  3. بجانب الخدمات، انقر على "إضافة خدمة" .
  4. اختَر Admin Directory API وانقر على إضافة.

تشغيل العيّنة

في محرِّر "برمجة تطبيقات Google"، انقر على تشغيل.

في المرة الأولى التي تشغّل فيها النموذج، سيُطلب منك السماح بالوصول إليه:

  1. انقر على مراجعة الأذونات.
  2. اختر حسابًا.
  3. انقر على سماح.

يظهر سجلّ تنفيذ النص البرمجي في أسفل النافذة.

الخطوات التالية