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

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

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

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

الأهداف

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

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

  • حساب على Google
  • الوصول إلى Google Drive

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

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

sheets/quickstart/quickstart.gs
/**
 * Creates a Sheets API service object and prints the names and majors of
 * students in a sample spreadsheet:
 * https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit
 * @see https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/get
 */
function logNamesAndMajors() {
  const spreadsheetId = "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms";
  const rangeName = "Class Data!A2:E";
  try {
    // Get the values from the spreadsheet using spreadsheetId and range.
    const values = Sheets.Spreadsheets.Values.get(
      spreadsheetId,
      rangeName,
    ).values;
    //  Print the values from spreadsheet if values are available.
    if (!values) {
      console.log("No data found.");
      return;
    }
    console.log("Name, Major:");
    for (const row in values) {
      // Print columns A and E, which correspond to indices 0 and 4.
      console.log(" - %s, %s", values[row][0], values[row][4]);
    }
  } catch (err) {
    // TODO (developer) - Handle Values.get() exception from Sheet API
    console.log(err.message);
  }
}

  1. انقر على "حفظ" .
  2. انقر على مشروع بلا عنوان، واكتب البدء السريع، ثم انقر على إعادة التسمية.

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

تفعيل Google Sheets API

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

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

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

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

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

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

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

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