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

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

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

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

الأهداف

  • إعداد البيئة
  • إنشاء النص البرمجي وإعداده
  • تشغيل النص البرمجي

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

  • نطاق Google Workspace تم تفعيل إمكانية الوصول إلى واجهة برمجة التطبيقات فيه .
  • حساب Google في هذا النطاق لديه امتيازات المشرف

  • الوصول إلى 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

افتح مشروع "برمجة تطبيقات Google".

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

تشغيل النموذج

في أداة تعديل النصوص البرمجية، انقر على تشغيل.

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

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

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

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