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