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

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

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

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

اهداف

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

پیش‌نیازها

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

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

  1. با رفتن به script.google.com/create ، یک اسکریپت جدید در ویرایشگر Apps Script ایجاد کنید.
  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. روی پروژه بدون عنوان کلیک کنید، عبارت Quickstart را تایپ کنید و روی تغییر نام کلیک کنید.

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

فعال کردن API گوگل شیت

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

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

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

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

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

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

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

مراحل بعدی