המדריך למתחילים של Google Apps Script

במדריכים למתחילים מוסבר איך להגדיר ולהפעיל אפליקציה שקוראת ל-Google Workspace API.

כדי לטפל בפרטים מסוימים בתהליך האימות וההרשאה, המדריכים למתחילים של Google Workspace משתמשים בספריות לקוח ה-API. אנחנו ממליצים להשתמש בספריות הלקוח של האפליקציות שלכם. המדריך למתחילים משתמש בגישת אימות פשוטה שמתאימה לסביבת הבדיקה. בסביבת ייצור, מומלץ ללמוד על אימות והרשאה לפני לבחור את פרטי הכניסה שמתאימים לאפליקציה.

יוצרים סקריפט של Google Apps ששולח בקשות ל-API של Google Slides.

מטרות

  • יוצרים את הסקריפט.
  • מפעילים את Google Slides API.
  • מריצים את הדוגמה.

דרישות מוקדמות

  • חשבון Google.
  • גישה ל-Google Drive

יצירת הסקריפט

  1. כדי ליצור סקריפט חדש, עוברים אל 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

  1. פותחים את פרויקט Apps Script.
  2. לוחצים על עריכה .
  3. ליד שירותים, לוחצים על 'הוספת שירות' .
  4. בוחרים ב-Google Slides API ולוחצים על הוספה.

הרצת הדוגמה

בעורך Apps Script, לוחצים על Run.

בפעם הראשונה שמריצים את הדוגמה, מוצגת בקשה להעניק הרשאת גישה:

  1. לוחצים על בדיקת ההרשאות.
  2. בוחרים חשבון.
  3. לוחצים על אישור.

יומן הביצוע של הסקריפט מופיע בתחתית החלון.

השלבים הבאים