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

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

סימון R1C1

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

הצגת דוגמאות

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

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

טווח מוגן

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

השלבים הבאים