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

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

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

در Apps Script، پیش‌نمایش‌های Google Workspace از سرویس‌های پیشرفته گوگل برای فراخوانی APIهای Google Workspace و مدیریت برخی جزئیات جریان احراز هویت و مجوزدهی استفاده می‌کنند.

اهداف

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

پیش‌نیازها

  • یک دامنه Google Workspace با دسترسی API فعال .
  • یک حساب گوگل در آن دامنه با امتیازات مدیر.

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

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

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

افراد/شروع سریع/quickstart.gs
/**
 * @typedef {Object} EmailAddress
 * @see https://developers.google.com/people/api/rest/v1/people#Person
 * @property {string} value
 * Note: This is a partial definition.
 */

/**
 * @typedef {Object} Name
 * @see https://developers.google.com/people/api/rest/v1/people#Person
 * @property {string} displayName
 * Note: This is a partial definition.
 */

/**
 * @typedef {Object} Person
 * @see https://developers.google.com/people/api/rest/v1/people#Person
 * @property {Name[]} names
 * @property {EmailAddress[]} [emailAddresses]
 * Note: This is a partial definition.
 */

/**
 * @typedef {Object} Connection
 * @see https://developers.google.com/people/api/rest/v1/people.connections/list
 * @property {Person[]} connections
 * Note: This is a partial definition.
 */

/**
 * Print the display name if available for 10 connections.
 */
function listConnectionNames() {
  // Use the People API to list the connections of the logged in user.
  // See: https://developers.google.com/people/api/rest/v1/people.connections/list
  if (!People || !People.People || !People.People.Connections) {
    throw new Error("People service not enabled.");
  }
  const connections = People.People.Connections.list("people/me", {
    pageSize: 10,
    personFields: "names,emailAddresses",
  });
  if (!connections.connections) {
    console.log("No connections found.");
    return;
  }
  for (const person of connections.connections) {
    if (
      person.names &&
      person.names.length > 0 &&
      person.names[0].displayName
    ) {
      console.log(person.names[0].displayName);
    } else {
      console.log("No display name found for connection.");
    }
  }
}

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

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

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

پروژه Apps Script را باز کنید.

  1. روی ویرایشگر کلیک کنید.
  2. در کنار سرویس‌ها ، روی سرویس کلیک کنید.
  3. API افراد را انتخاب کنید و روی افزودن کلیک کنید.

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

در ویرایشگر اسکریپت برنامه‌ها، روی اجرا (Run) کلیک کنید.

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

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

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

مراحل بعدی