בקטע הזה אנחנו מציגים codelab שאפשר להשתמש בו כדי להכיר את Google Sheets API. הוספנו גם קבוצת דוגמאות ל"מתכונים" שמדגימות איך לתרגם פעולה רצויה ב-Google Sheets לבקשת API.
לעיתים קרובות יש יותר מדרך אחת להשלים משימה נתונה באמצעות ה-API. כשאתם מחליטים איך לגשת למשימה, חשוב לזכור את הנקודות הבאות:
- אם אתם צריכים לקרוא או לכתוב ערכים של תאים, האוסף
spreadsheets.values
עדיף יותר מהאוסףspreadsheets
. בממשק של הגרסה הקודמת קל יותר לבצע פעולות פשוטות של קריאה/כתיבה. כשהדבר אפשרי, כדאי להשתמש בשיטות האצווה (
spreadsheet.batchUpdate
,spreadsheet.values.batchGet
וגםspreadsheet.values.batchUpdate
) כדי לקבץ כמה בקשות בקריאה אחת ל-method. שימוש בשיטות אצווה אלה משפר את היעילות מכיוון שהן:- צמצם את תקורת ה-HTTP של הלקוח.
- לצמצם את מספר השאילתות.
- לצמצם את מספר הגרסאות הקודמות במסמך.
- חשוב לוודא שכל השינויים בקבוצה יהיו אטומים.
מתכונים
הדוגמאות בקטע הזה ממחישות איך לבטא פעולות נפוצות ב-Sheets באמצעות בקשות של Sheets API v4.
הדוגמאות האלה מוצגות בפורמט של בקשות HTTP ניטרליות מבחינת שפה. כדי ללמוד איך להטמיע פרוטוקולים של בקשות API ל-Sheets בשפה מסוימת באמצעות ספריות הלקוח של Google API, תוכלו להיעזר במדריכים קריאה וכתיבה של ערכי תאים ועדכון גיליונות אלקטרוניים.
המתכונים בקטע הזה מחולקים לקטגוריות הבאות:
- קריאה בסיסית – מתכונים שמראים איך לקרוא ערכים מגיליון.
- כתיבה בסיסית – מתכונים שמראים איך לכתוב ערכים בגיליון.
- עיצוב בסיסי – מתכונים שמראים איך לשנות את המראה של גיליונות ותאים.
- Charts – מתכונים שמראים איך ליצור ולשנות תרשימים בגיליון.
- עיצוב מותנה – מתכונים שמראים איך לשנות את מראה התא בהתאם לתנאים.
- פעולות על נתונים – מתכונים שמראים איך ליצור, להעביר ולשנות נתונים בגיליון אלקטרוני.
- טווחים בעלי שם וטווחים מוגנים – מתכונים שמראים איך ליצור, לעדכן ולהסיר טווחים מוגנים בעלי שם וטווחים בגיליון אלקטרוני.
- טבלאות צירים – מתכונים שמדגימים איך ליצור טבלאות צירים בגיליון.
- פעולות של שורות ועמודות – מתכונים שמראה איך להוסיף, להסיר ולהעביר שורות ועמודות, ולעדכן את המאפיינים שלהם.
- פעולות על גיליונות – מתכונים שמדגימים איך ליצור, לנקות, להעתיק ולמחוק גיליונות, וגם לשלוט במאפיינים שלהם.