شروع سریع اسکریپت Google Apps

Quickstarts نحوه راه‌اندازی و اجرای برنامه‌ای را توضیح می‌دهد که Google Workspace API را فراخوانی می‌کند.

راه‌اندازی‌های سریع Google Workspace از کتابخانه‌های سرویس گیرنده API برای رسیدگی به برخی از جزئیات جریان احراز هویت و مجوز استفاده می‌کنند. توصیه می کنیم از کتابخانه های سرویس گیرنده برای برنامه های خود استفاده کنید. این شروع سریع از یک رویکرد احراز هویت ساده استفاده می کند که برای یک محیط آزمایشی مناسب است. برای یک محیط تولید، توصیه می‌کنیم قبل از انتخاب اعتبارنامه‌های دسترسی مناسب برای برنامه‌تان، درباره احراز هویت و مجوز یاد بگیرید.

یک اسکریپت Google Apps ایجاد کنید که درخواست هایی را به Directory API ارسال می کند.

اهداف

  • محیط را پیکربندی کنید.
  • اسکریپت را ایجاد و پیکربندی کنید.
  • اسکریپت را اجرا کنید.

پیش نیازها

  • دسترسی به گوگل درایو

اسکریپت را ایجاد کنید

  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. روی پروژه Untitled کلیک کنید، Quickstart را تایپ کنید و روی تغییر نام کلیک کنید.

اسکریپت را پیکربندی کنید

Directory API را فعال کنید

  1. پروژه Apps Script را باز کنید.
  1. روی ویرایشگر کلیک کنید.
  2. در کنار Services ، روی Add a service کلیک کنید.
  3. Admin Directory API را انتخاب کرده و روی Add کلیک کنید.

نمونه را اجرا کنید

در ویرایشگر Apps Script، روی Run کلیک کنید.

اولین باری که نمونه را اجرا می‌کنید، از شما می‌خواهد دسترسی را مجاز کنید:

  1. روی بررسی مجوزها کلیک کنید.
  2. یک حساب کاربری انتخاب کنید.
  3. روی Allow کلیک کنید.

گزارش اجرای اسکریپت در پایین پنجره ظاهر می شود.

مراحل بعدی

،

Quickstarts نحوه راه‌اندازی و اجرای برنامه‌ای را توضیح می‌دهد که Google Workspace API را فراخوانی می‌کند.

راه‌اندازی‌های سریع Google Workspace از کتابخانه‌های سرویس گیرنده API برای رسیدگی به برخی از جزئیات جریان احراز هویت و مجوز استفاده می‌کنند. توصیه می کنیم از کتابخانه های سرویس گیرنده برای برنامه های خود استفاده کنید. این شروع سریع از یک رویکرد احراز هویت ساده استفاده می کند که برای یک محیط آزمایشی مناسب است. برای یک محیط تولید، توصیه می‌کنیم قبل از انتخاب اعتبارنامه‌های دسترسی مناسب برای برنامه‌تان، درباره احراز هویت و مجوز یاد بگیرید.

یک اسکریپت Google Apps ایجاد کنید که درخواست هایی را به Directory API ارسال می کند.

اهداف

  • محیط را پیکربندی کنید.
  • اسکریپت را ایجاد و پیکربندی کنید.
  • اسکریپت را اجرا کنید.

پیش نیازها

  • دسترسی به گوگل درایو

اسکریپت را ایجاد کنید

  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. روی پروژه Untitled کلیک کنید، Quickstart را تایپ کنید و روی تغییر نام کلیک کنید.

اسکریپت را پیکربندی کنید

Directory API را فعال کنید

  1. پروژه Apps Script را باز کنید.
  1. روی ویرایشگر کلیک کنید.
  2. در کنار Services ، روی Add a service کلیک کنید.
  3. Admin Directory API را انتخاب کرده و روی Add کلیک کنید.

نمونه را اجرا کنید

در ویرایشگر Apps Script، روی Run کلیک کنید.

اولین باری که نمونه را اجرا می‌کنید، از شما می‌خواهد دسترسی را مجاز کنید:

  1. روی بررسی مجوزها کلیک کنید.
  2. یک حساب کاربری انتخاب کنید.
  3. روی Allow کلیک کنید.

گزارش اجرای اسکریپت در پایین پنجره ظاهر می شود.

مراحل بعدی