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

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

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

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

اهداف

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

پیش‌نیازها

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

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

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

اسلایدها/شروع سریع/شروع سریع.gs
/**
 * Creates a Slides API service object and logs the number of slides and
 * elements in a sample presentation:
 * https://docs.google.com/presentation/d/1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc/edit
 */
function logSlidesAndElements() {
  const presentationId = "1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc";
  try {
    // Gets the specified presentation using presentationId
    const presentation = Slides.Presentations.get(presentationId);
    const slides = presentation.slides;
    // Print the number of slides and elements in presentation
    console.log("The presentation contains %s slides:", slides.length);
    for (let i = 0; i < slides.length; i++) {
      console.log(
        "- Slide # %s contains %s elements.",
        i + 1,
        slides[i].pageElements.length,
      );
    }
  } catch (err) {
    // TODO (developer) - Handle  Presentation.get() exception from Slides API
    console.log("Failed to found Presentation with error %s", err.message);
  }
}

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

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

فعال کردن API اسلایدهای گوگل

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

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

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

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

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

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

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

مراحل بعدی