دليل سريع للبدء في Google Apps Script

أنشئ نص برمجيًا في Google Apps Script يرسل طلبات إلى People API.

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

في "برمجة التطبيقات"، تستخدم أدوات البدء السريع في Google Workspace خدمات Google المتقدّمة لاستدعاء واجهات برمجة التطبيقات في Google Workspace والتعامل مع بعض تفاصيل عملية المصادقة والتفويض.

الأهداف

  • ضبط البيئة
  • أنشِئ النص البرمجي وأعدّه.
  • شغِّل النص البرمجي.

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

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

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

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

people/quickstart/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. انقر على مشروع بلا عنوان، واكتب البدء السريع، ثم انقر على إعادة تسمية.

ضبط النص البرمجي

تفعيل People API

افتح مشروع Apps Script.

  1. انقر على أداة التعديل .
  2. بجانب الخدمات، انقر على "إضافة خدمة" .
  3. اختَر People API وانقر على إضافة.

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

في محرِّر Apps Script، انقر على تشغيل.

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

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

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

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