דוגמאות

בקטע הזה נספק codelab שיעזור לכם להכיר את Google Sheets API. בנוסף, מוצגות דוגמאות ל'מתכונים' שממחישות איך לתרגם פעולה מתוכננת ב-Google Sheets לבקשת API.

לרוב יש יותר מדרך אחת להשלים משימה מסוימת באמצעות ה-API. כשאתם מחליטים איך לגשת למשימה, חשוב לזכור את הנקודות הבאות:

• אם אתם צריכים לקרוא או לכתוב ערכים של תאים, האוסף spreadsheets.values הוא בחירה טובה יותר מהאוסף spreadsheets. קל יותר להשתמש בממשק של ה-API הקודם לביצוע פעולות קריאה/כתיבה פשוטות.

• כשהדבר אפשרי, כדאי להשתמש בשיטות האצווה (spreadsheet.batchUpdate,‏ spreadsheet.values.batchGet ו-spreadsheet.values.batchUpdate) כדי לקבץ כמה בקשות בקריאה אחת לשיטה. השימוש בשיטות האצווה האלה משפר את היעילות כי:

  • הפחתת התקורה של HTTP בלקוח.
  • צמצום מספר השאילתות.
  • כדאי לצמצם את מספר הגרסאות של המסמך.
  • לוודא את האטומיות של כל השינויים בקבוצה.

מתכונים

הדוגמאות שמפורטות בקטע הזה מראות איך להביע פעולות נפוצות ב-Sheets כבקשות של Sheets API v4.

הדוגמאות האלה מוצגות כבקשות HTTP כדי שיהיו ניטרליות מבחינת שפה. במאמרים קריאה וכתיבה של ערכי תא ועדכון גיליונות אלקטרוניים מוסבר איך מטמיעים פרוטוקולים של בקשות Sheets API בשפה ספציפית באמצעות ספריות לקוח של Google API.

המתכונים בקטע הזה מחולקים לקטגוריות הבאות:

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