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

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

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

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

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

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

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

גיליון

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

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

תא

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

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

הצגת דוגמאות

  • Sheet1!A1:B2 מתייחס לכל התאים בשתי השורות והעמודות הראשונות ב-Sheets1.
  • הערך Sheet1!A:A מתייחס לכל התאים בעמודה הראשונה של Sheet1.
  • Sheet1!1:2 מתייחס לכל התאים בשתי השורות הראשונות של Sheet1.
  • Sheet1!A5:A מתייחס לכל התאים בעמודה הראשונה בגיליון 1, משורה 5 ואילך.
  • A1:B2 מתייחס לכל התאים בשתי השורות והעמודות הראשונות בגיליון הגלוי הראשון.
  • Sheet1 מתייחס לכל התאים בגיליון 1.
  • 'Jon's_Data'!A1:D5 מתייחס לכל התאים ב-5 השורות הראשונות ו-4 העמודות בגיליון שנקרא "Jon's_Data".
  • 'My Custom Sheet'!A:A מתייחס לכל התאים בעמודה הראשונה של גיליון בשם "My Custom Sheet" (הגיליון המותאם אישית שלי).
  • הערך 'My Custom Sheet' מתייחס לכל התאים בעמודה My Custom Sheet (הגיליון המותאם אישית שלי).

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

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

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

הצגת דוגמאות

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