דוגמאות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בקטע הזה מוצג codelab שבה תוכלו להשתמש כדי להכיר את Google Sheets API. בנוסף, יש כאן קבוצה של דוגמאות ל'מתכונים' שממחישות איך לתרגם פעולה מיועדת ב-Google Sheets לבקשת API.
לעתים קרובות יש יותר מדרך אחת להשלים משימה מסוימת באמצעות ה-API. כשאתם מחליטים איך לגשת למשימה, חשוב לזכור את הנקודות הבאות:
מתכונים
בדוגמאות שמופיעות בקטע הזה אפשר לראות איך לבטא פעולות נפוצות ב-Sheets כבקשות Sheets API v4.
הדוגמאות האלה מוצגות בצורה של בקשות HTTP כדי להיות ניטרליות מבחינת שפה. במאמרים קריאה וכתיבה של ערכי תאים ועדכון של גיליונות אלקטרוניים מוסבר איך מטמיעים פרוטוקולים של בקשות ל-Sheets API בשפה ספציפית באמצעות ספריות לקוח של Google API.
המתכונים בקטע הזה מחולקים לקטגוריות הבאות:
- קריאה בסיסית – מתכונים שמראים איך לקרוא ערכים מגיליון.
- כתיבה בסיסית – מתכונים שמראים איך לכתוב ערכים בגיליון.
- עיצוב בסיסי – מתכונים שמראים איך לשנות את המראה של גיליונות ותאים.
- תרשימים – מתכונים שמראים איך ליצור ולשנות תרשימים בגיליון.
- עיצוב מותנה – מתכונים שמראים איך לשנות את המראה של תא על סמך תנאים.
- פעולות על נתונים – מתכונים שמראים איך ליצור נתונים בגיליון אלקטרוני, להעביר אותם ולבצע בהם מניפולציות.
- טווחים עם שם וטווחים מוגנים – מתכונים שמראים איך ליצור, לעדכן ולהסיר טווחים עם שם וטווחים מוגנים בגיליון אלקטרוני.
- טבלאות צירים – מתכונים שמראים איך ליצור טבלאות צירים בגיליון.
- פעולות על שורות ועמודות – מתכונים שמראים איך להוסיף, להסיר ולהעביר שורות ועמודות, ואיך לעדכן את המאפיינים שלהן.
- פעולות בגיליון – מתכונים שמראים איך ליצור, לנקות, להעתיק ולמחוק גיליונות, וגם איך לשלוט במאפיינים שלהם.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-29 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Samples\n\nThis section presents a\n[codelab](https://codelabs.developers.google.com/codelabs/sheets-api/) you can\nuse to become familiar with the Google Sheets API. Also provided are a set of\n\"recipe\" examples that demonstrate how to translate an intended Google Sheets\naction into an API request.\n\nOften there's more than one way to complete a given task with the API. When\nyou're deciding on how to approach a task, keep the following in mind:\n\n- If you need to read or write cell values, the [`spreadsheets.values`](/workspace/sheets/api/reference/rest/v4/spreadsheets.values) collection is a better choice than the [`spreadsheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets) collection. The former's interface is easier to use for simple read/write operations.\n- Wherever possible, use the batch methods\n ([`spreadsheet.batchUpdate`](/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate),\n [`spreadsheet.values.batchGet`](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGet),\n and\n [`spreadsheet.values.batchUpdate`](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdate))\n to bundle multiple requests into a single method call. Using these batch\n methods improves efficiency as they:\n\n - Reduce client HTTP overhead.\n - Reduce the number of queries made.\n - Reduce the number of revisions on the doc.\n - Ensure atomicity of all the changes in the batch.\n\nRecipes\n-------\n\nThe examples listed in this section demonstrate how to express common actions in\nSheets as Sheets API v4 requests.\n\nThese examples are presented in the form of HTTP requests to be language\nneutral. To learn how to implement Sheets API request protocols in a\nspecific language using Google API client libraries, see the [Read \\& write cell\nvalues](/workspace/sheets/api/guides/values) and [Update\nspreadsheets](/workspace/sheets/api/guides/batchupdate) guides.\n\nRecipes in this section are divided into the following categories:\n\n- [Basic reading](/workspace/sheets/api/samples/reading)---Recipes that show how to read values from a sheet.\n- [Basic writing](/workspace/sheets/api/samples/writing)---Recipes that show how to write values to a sheet.\n- [Basic formatting](/workspace/sheets/api/samples/formatting)---Recipes that show how to change the appearance of sheets and cells.\n- [Charts](/workspace/sheets/api/samples/charts)---Recipes that show how to create and alter charts in a sheet.\n- [Conditional formatting](/workspace/sheets/api/samples/conditional-formatting)--- Recipes that show how to alter cell appearance based on conditions.\n- [Data operations](/workspace/sheets/api/samples/data)---Recipes that show how to create, move, and manipulate data in a spreadsheet.\n- [Named \\& protected\n ranges](/workspace/sheets/api/samples/ranges)---Recipes that show how to create, update, and remove named and protected ranges in a spreadsheet.\n- [Pivot tables](/workspace/sheets/api/samples/pivot-tables)---Recipes that show how to create pivot tables in a sheet.\n- [Row \\& column\n operations](/workspace/sheets/api/samples/rowcolumn)---Recipes that show how to add, remove, and move rows and columns, and update their properties.\n- [Sheet operations](/workspace/sheets/api/samples/sheet)---Recipes that show how to create, clear, copy, and delete sheets, and also control their properties."]]
