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

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

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

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

اهداف

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

پیش نیازها

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

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

  1. با رفتن به script.google.com/create یک اسکریپت جدید ایجاد کنید.
  2. محتوای ویرایشگر اسکریپت را با کد زیر جایگزین کنید:

people/quickstart/quickstart.gs
/**
 * Print the display name if available for 10 connections.
 */
function listConnectionNames() {
  try {
    /**
     * List the 10 connections/contacts of user
     * @see https://developers.google.com/people/api/rest/v1/people.connections/list
     */
    const connections = People.People.Connections.list('people/me', {
      pageSize: 10,
      personFields: 'names,emailAddresses'
      // use other query parameter here if needed.
    });
    connections.connections.forEach((person) => {
      // if contacts/connections is available, print the name of person.
      if (person.names && person.names.length === 0) {
        console.log('No display name found for connection.');
        return;
      }
      console.log(person.names[0].displayName);
    });
  } catch (err) {
    // TODO (developer) - Handle exception from People API
    console.log('Failed with error %s', err.message);
  }
}

  1. روی ذخیره کلیک کنید .
  2. روی پروژه Untitled کلیک کنید، Quickstart را تایپ کنید و روی تغییر نام کلیک کنید.

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

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

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

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

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

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

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

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

مراحل بعدی