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

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

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

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

الأهداف

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

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

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

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

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

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

إعداد النص البرمجي

تفعيل Google Slides API

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

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

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

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

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

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

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

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