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

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

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

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

גיליון אלקטרוני

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

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

גיליון

דף או כרטיסייה בגיליון אלקטרוני. משאב גיליון מייצג כל גיליון ויש לו כותרת וערך מספרי sheetId ייחודיים. מזהה הגיליון מופיע בכתובת ה-URL של Google Sheets:

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

תא

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

סימון A1

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

הצגת דוגמאות
  • Sheet1!A1:B2 מתייחס לשני התאים הראשונים בשתי השורות העליונות של Sheet1.
  • הערך Sheet1!A:A מתייחס לכל התאים בעמודה הראשונה של Sheet1.
  • Sheet1!1:2 מתייחס לכל התאים בשתי השורות הראשונות של Sheet1.
  • Sheet1!A5:A מתייחס לכל התאים בעמודה הראשונה בגיליון 1, משורה 5 ואילך.
  • הערך A1:B2 מתייחס לשני התאים הראשונים בשתי השורות העליונות של הגיליון הגלוי הראשון.
  • Sheet1 מתייחס לכל התאים בגיליון 1.
  • 'My Custom Sheet'!A:A מתייחס לכל התאים בעמודה הראשונה של גיליון בשם "My Custom Sheet" (הגיליון המותאם אישית שלי). בשמות של גיליונות עם רווחים, תווים מיוחדים או שילוב אלפאנומרי, צריך להשתמש במירכאות בודדות.
  • הערך '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] מתייחס לתא שנמצא מתחת ל-3 שורות ועמודה אחת מימין לתא הנוכחי.
טווח בעל שם

תא או טווח מוגדרים של תאים עם שם מותאם אישית, כדי לפשט את ההפניות בכל האפליקציה. משאב FilterView מייצג טווח בעל שם.

טווח מוגן

תא מוגדר או טווח של תאים שאי אפשר לשנות. משאב ProtectedRange מייצג טווח מוגן.

השלבים הבאים