Contoh
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Bagian ini menyajikan
codelab yang dapat Anda
gunakan untuk memahami Google Sheets API. Selain itu, disediakan serangkaian contoh "resep" yang menunjukkan cara menerjemahkan tindakan Google Spreadsheet yang diinginkan menjadi permintaan API.
Sering kali ada lebih dari satu cara untuk menyelesaikan tugas tertentu dengan API. Saat
Anda memutuskan cara mengerjakan suatu tugas, perhatikan hal berikut:
- Jika Anda perlu membaca atau menulis nilai sel, koleksi
spreadsheets.values
adalah pilihan yang lebih baik daripada koleksi
spreadsheets. Antarmuka yang pertama lebih mudah digunakan untuk operasi baca/tulis
sederhana.
Jika memungkinkan, gunakan metode batch
(spreadsheet.batchUpdate,
spreadsheet.values.batchGet,
dan
spreadsheet.values.batchUpdate)
untuk menggabungkan beberapa permintaan ke dalam satu panggilan metode. Penggunaan metode batch ini meningkatkan efisiensi karena:
- Mengurangi overhead HTTP klien.
- Kurangi jumlah kueri yang dibuat.
- Kurangi jumlah revisi pada dokumen.
- Pastikan atomisitas semua perubahan dalam batch.
Resep
Contoh yang tercantum di bagian ini menunjukkan cara menyatakan tindakan umum di
Spreadsheet sebagai permintaan Sheets API v4.
Contoh ini disajikan dalam bentuk permintaan HTTP agar netral terhadap bahasa. Untuk mempelajari cara menerapkan protokol permintaan Sheets API dalam
bahasa tertentu menggunakan library klien Google API, lihat panduan Membaca & menulis nilai sel dan Memperbarui
spreadsheet.
Resep di bagian ini dibagi menjadi kategori berikut:
- Membaca dasar—Resep yang menunjukkan cara membaca nilai dari sheet.
- Penulisan dasar—Resep yang menunjukkan cara menulis nilai ke sheet.
- Pemformatan dasar—Resep
yang menunjukkan cara mengubah tampilan sheet dan sel.
- Diagram—Resep yang menunjukkan cara membuat dan mengubah diagram dalam sheet.
- Format bersyarat—
Resep yang menunjukkan cara mengubah tampilan sel berdasarkan kondisi.
- Operasi data—Resep yang menunjukkan cara membuat, memindahkan, dan memanipulasi data dalam spreadsheet.
- Rentang bernama & terlindungi—Resep yang menunjukkan cara membuat, memperbarui, dan menghapus rentang bernama dan terlindungi dalam spreadsheet.
- Tabel pivot—Resep
yang menunjukkan cara membuat tabel pivot di spreadsheet.
- Operasi baris & kolom—Resep yang menunjukkan
cara menambahkan, menghapus, dan memindahkan baris dan kolom, serta memperbarui propertinya.
- Operasi sheet—Resep yang menunjukkan cara membuat, menghapus, menyalin, dan menghapus sheet, serta mengontrol propertinya.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
