דוגמיות

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

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

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

• כשזה אפשרי, משתמשים בשיטות אצווה (spreadsheet.batchUpdate, spreadsheet.values.batchGet, וגם spreadsheet.values.batchUpdate) כדי לקבץ מספר בקשות בהפעלת method אחת. שימוש בקבוצות האלה משפרות את היעילות, מכיוון שהן:

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

מתכונים

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

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

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

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