סקירה כללית על 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 מתייחס לכל התאים בגיליון בשם A1. באופן דומה, "Sheet1" מתייחס לכל התאים ב-Sheet1. עם זאת, אם יש טווח בשם "Sheet1", אז Sheet1 מתייחס לטווח בעל השם ו-'Sheet1' מתייחס לגיליון.
סימון R1C1

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

הצגת דוגמאות

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

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

טווח מוגן

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

השלבים הבאים