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