סקירה כללית על Google Sheets API

‫Google Sheets API הוא ממשק RESTful שמאפשר לקרוא ולשנות נתונים בגיליון אלקטרוני. ‫Sheets API מאפשר לכם:

  • יצירת גיליונות אלקטרוניים
  • קריאה וכתיבה של ערכי תאים בגיליון אלקטרוני
  • עדכון העיצוב של הגיליון האלקטרוני
  • ניהול של גיליונות מקושרים

בהמשך מפורטת רשימה של מונחים נפוצים שמשמשים ב-Sheets API:

Spreadsheet

האובייקט הראשי ב-Google Sheets. הוא יכול להכיל כמה תגי Sheets, כל אחד עם מידע מובנה שמופיע בתוך Cells. מקור המידע spreadsheets מייצג גיליון אלקטרוני. הוא מכיל ערך ייחודי של spreadsheetId.

מזהה הגיליון האלקטרוני
המזהה הייחודי של גיליון אלקטרוני. זו מחרוזת מסוימת שמכילה אותיות, מספרים ותווים מיוחדים מסוימים, שמפנה לגיליון אלקטרוני, ואפשר להפיק אותה מכתובת ה-URL של הגיליון האלקטרוני. המזהים של הגיליונות האלקטרוניים הם קבועים, גם אם השם של הגיליון האלקטרוני משתנה.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
גיליון

דף או כרטיסייה בגיליון אלקטרוני. המשאב Sheets מייצג גיליון. הוא מכיל ערך מספרי ייחודי sheetId וגיליון title כחלק מהאובייקט SheetProperties.

מזהה גיליון
המזהה הייחודי של גיליון ספציפי בגיליון אלקטרוני. זהו מספר שלם שמכיל ספרות שמפנות לגיליון, ואפשר להפיק אותו מכתובת ה-URL של הגיליון האלקטרוני. מזהי הגיליונות הם קבועים, גם אם השם של הגיליון משתנה. דוגמה מופיעה בקטע מזהה גיליון אלקטרוני.
Cell

שדה נתונים או טקסט בודד בגיליון. התאים מסודרים בשורות ובעמודות, ואפשר לקבץ אותם כטווח תאים. משאב Cells מייצג כל תא, אבל אין לו ערך מזהה ייחודי. במקום זאת, התאים מזוהים באמצעות קואורדינטות של שורות ועמודות.

שיטת הסימון A1
תחביר שמשמש להגדרת תא או טווח של תאים באמצעות מחרוזת שמכילה את שם הגיליון בתוספת הקואורדינטות של תא ההתחלה ותא הסיום, תוך שימוש באותיות של העמודות ובמספרים של השורות. השיטה הזו היא הכי נפוצה ושימושית כשמפנים לטווח מוחלט של תאים.
  • ‫Sheet1!A1:B2 מתייחס לכל התאים בשתי השורות והעמודות הראשונות של Sheet1.
  • ‫Sheet1!A:A מתייחס לכל התאים בעמודה הראשונה של Sheet1.
  • ‫Sheet1!1:2 מתייחס לכל התאים בשתי השורות הראשונות של Sheet1.
  • ‫Sheet1!A5:A מתייחס לכל התאים בעמודה הראשונה של גיליון 1, משורה 5 ואילך.
  • ‫A1:B2 מתייחס לכל התאים בשתי השורות והעמודות הראשונות של הגיליון הראשון שמוצג.
  • ‫Sheet1 מתייחס לכל התאים בגיליון 1.
  • ‫'Jon's_Data'!A1:D5 מתייחס לכל התאים בחמש השורות הראשונות ובארבע העמודות הראשונות של גיליון בשם Jon's_Data.
  • ‫'My Custom Sheet'!A:A מתייחס לכל התאים בעמודה הראשונה של גיליון שנקרא My Custom Sheet.
  • ‫'My Custom Sheet' מתייחס לכל התאים בגיליון המותאם אישית.

אם שם הגיליון מכיל רווחים או תווים מיוחדים, צריך להשתמש במירכאות בודדות.

טיפ: אם אפשר, כדאי להשתמש בשמות שונים לאובייקטים בגיליונות האלקטרוניים. לדוגמה, A1 (בלי מרכאות) מתייחס לתא A1 בגיליון הראשון שגלוי. ‫'A1' מתייחס לגיליון בשם A1. באופן דומה, Sheet1 מתייחס לגיליון בשם Sheet1. אבל אם יש טווח תאים בעל שם שנקרא Sheet1, אז Sheet1 מתייחס לטווח התאים בעל השם ו-'Sheet1' מתייחס לגיליון.

שיטת הסימון R1C1
תחביר שמשמש להגדרת תא או טווח של תאים באמצעות מחרוזת שמכילה את שם הגיליון בתוספת הקואורדינטות של תא ההתחלה ותא הסיום באמצעות מספרי שורות ומספרי עמודות. השיטה הזו פחות נפוצה מסימון A1, אבל היא יכולה להיות שימושית כשמפנים לטווח של תאים ביחס למיקום של תא נתון.
  • ‫Sheet1!R1C1:R2C2 מתייחס לשני התאים הראשונים בשתי השורות העליונות של Sheet1.
  • ‫R1C1:R2C2 מתייחס לשני התאים הראשונים בשתי השורות העליונות של הגיליון הראשון שגלוי.
  • ‫Sheet1!R[3]C[1] מתייחס לתא שנמצא שלוש שורות מתחת לתא הנוכחי ועמודה אחת מימין לו.
טווח תאים בעל שם
תא מוגדר או טווח תאים מוגדר עם שם מותאם אישית כדי לפשט את ההפניות באפליקציה. משאב FilterView מייצג טווח תאים בעל שם.
טווח תאים מוגן
תא או טווח תאים מוגדרים שלא ניתן לשנות. מקור מידע ProtectedRange מייצג טווח תאים מוגן.