Ringkasan Google Sheets API
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Google Sheets API adalah antarmuka RESTful yang memungkinkan Anda membaca dan mengubah data spreadsheet. Sheets API memungkinkan Anda:
- Membuat spreadsheet
- Membaca dan menulis nilai sel spreadsheet
- Memperbarui pemformatan spreadsheet
- Mengelola Sheet yang Terhubung
Berikut adalah daftar istilah umum yang digunakan di Sheets API:
- Spreadsheet
Objek utama di Google Spreadsheet. Dapat berisi beberapa Sheets, yang masing-masing
dengan informasi terstruktur yang ada dalam Cells. Resource
spreadsheets
merepresentasikan spreadsheet. Kolom ini berisi nilai spreadsheetId
yang unik.
- ID Spreadsheet
- ID unik untuk spreadsheet. String ini adalah string tertentu yang berisi huruf, angka, dan beberapa karakter khusus yang merujuk ke spreadsheet dan dapat diperoleh dari URL spreadsheet. ID Spreadsheet bersifat stabil, meskipun nama spreadsheet berubah.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
- Spreadsheet
Halaman atau tab dalam spreadsheet. Resource
Sheets
mewakili sheet. Objek ini berisi nilai sheetId numerik unik dan title sheet sebagai bagian dari
objek
SheetProperties.
- ID Sheet
- ID unik untuk sheet tertentu dalam spreadsheet. Ini adalah
bilangan bulat tertentu yang berisi angka yang merujuk ke sheet dan dapat
diperoleh dari URL spreadsheet. ID sheet bersifat stabil, meskipun nama sheet berubah. Sebagai contoh, lihat ID Spreadsheet.
- Sel
Kolom teks atau data individual dalam sheet. Sel diatur dalam baris
dan kolom, serta dapat dikelompokkan sebagai rentang sel. Resource
Cells
mewakili setiap sel, tetapi tidak memiliki nilai ID unik.
Sebagai gantinya, koordinat baris dan kolom mengidentifikasi sel.
- Notasi A1
- Sintaksis yang digunakan untuk menentukan sel atau rentang sel dengan string yang
berisi nama sheet serta koordinat sel awal dan akhir menggunakan
huruf kolom dan nomor baris. Metode ini adalah yang paling umum dan berguna
saat mereferensikan rentang sel absolut.
Sheet1!A1:B2 mengacu pada semua sel di dua baris dan kolom pertama Sheet1.Sheet1!A:A mengacu pada semua sel di kolom pertama Sheet1.Sheet1!1:2 mengacu pada semua sel di dua baris pertama Sheet1.Sheet1!A5:A mengacu pada semua sel di kolom pertama Sheet 1, dari baris 5 dan seterusnya.A1:B2 merujuk ke semua sel dalam dua baris dan kolom pertama pada sheet pertama yang terlihat.Sheet1 mengacu pada semua sel di Sheet1.'Jon's_Data'!A1:D5 merujuk ke semua sel dalam lima baris dan empat kolom pertama pada sheet bernama "Jon's_Data".'My Custom Sheet'!A:A merujuk ke semua sel di kolom pertama sheet bernama "My Custom Sheet".'My Custom Sheet' mengacu pada semua sel di "My Custom Sheet".
Tanda kutip tunggal diperlukan untuk nama sheet yang berisi spasi atau karakter khusus.
Tips: Jika memungkinkan, gunakan nama yang berbeda untuk objek di spreadsheet Anda. Misalnya, A1 (tanpa tanda kutip) mengacu pada sel A1 di sheet pertama yang terlihat. 'A1' mengacu pada sheet dengan nama A1. Demikian pula, Sheet1 merujuk ke sheet dengan nama Sheet1. Namun, jika ada rentang bernama yang berjudul "Sheet1", maka Sheet1 merujuk ke rentang bernama dan 'Sheet1' merujuk ke sheet.
- Notasi R1C1
- Sintaksis yang digunakan untuk menentukan sel atau rentang sel dengan string yang
berisi nama sheet serta koordinat sel awal dan akhir menggunakan
nomor baris dan nomor kolom. Metode ini kurang umum dibandingkan notasi A1,
tetapi dapat berguna saat mereferensikan rentang sel relatif terhadap posisi sel
tertentu.
Sheet1!R1C1:R2C2 mengacu pada dua sel pertama di dua baris teratas Sheet1.R1C1:R2C2 merujuk pada dua sel pertama di dua baris teratas pada sheet pertama yang terlihat.Sheet1!R[3]C[1] mengacu pada sel yang berada tiga baris di bawah dan satu kolom di sebelah kanan sel saat ini.
- Rentang bernama
- Sel atau rentang sel yang ditentukan dengan nama kustom untuk menyederhanakan referensi
di seluruh aplikasi. Resource
FilterView
mewakili rentang bernama.
- Rentang dilindungi
- Sel atau rentang sel yang ditentukan yang tidak dapat diubah. Resource
ProtectedRange
mewakili rentang yang dilindungi.
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,["# Google Sheets API Overview\n\nThe Google Sheets API is a RESTful interface that lets you read and modify a\nspreadsheet's data. The Sheets API lets you:\n\n- Create spreadsheets\n- Read and write spreadsheet cell values\n- Update spreadsheet formatting\n- Manage Connected Sheets\n\nThe following is a list of common terms used in the Sheets API:\n\n*Spreadsheet*\n\n: The primary object in Google Sheets. It can contain multiple `Sheets`, each\n with structured information contained in `Cells`. The\n [`spreadsheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets)\n resource represents a spreadsheet. It contains a unique `spreadsheetId`\n value.\n\n *Spreadsheet ID*\n : The unique identifier for a spreadsheet. It's a particular string\n containing letters, numbers, and some special characters that reference a\n spreadsheet and it can be derived from the spreadsheet's URL. Spreadsheet\n IDs are stable, even if the spreadsheet name changes. \n\n https://docs.google.com/spreadsheets/d/\u003cvar translate=\"no\"\u003eSPREADSHEET_ID\u003c/var\u003e/edit?gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e#gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e\n\n*Sheet*\n\n: A page or tab within a spreadsheet. The\n [`Sheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets) resource\n represents a sheet. It contains a unique numeric `sheetId` value and sheet\n `title` as part of the\n [`SheetProperties`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#sheetproperties)\n object.\n\n *Sheet ID*\n : The unique identifier for a specific sheet within a spreadsheet. It's a\n particular integer containing numbers that reference a sheet and it can be\n derived from the spreadsheet's URL. Sheet IDs are stable, even if the sheet\n name changes. For an example, see [Spreadsheet ID](#spreadsheet-id).\n\n*Cell*\n\n: An individual field of text or data within a sheet. Cells are arranged in rows\n and columns, and can be grouped as a range of cells. The\n [`Cells`](/workspace/sheets/api/reference/rest/v4/spreadsheets/cells)\n resource represents each cell, but it doesn't have a unique ID value.\n Instead, row and column coordinates identify the cells.\n\n *A1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n column letters and row numbers. This method is the most common and useful\n when referencing an absolute range of cells.\n - `Sheet1!A1:B2` refers to all the cells in the first two rows and columns of Sheet1.\n - `Sheet1!A:A` refers to all the cells in the first column of Sheet1.\n - `Sheet1!1:2` refers to all the cells in the first two rows of Sheet1.\n - `Sheet1!A5:A` refers to all the cells of the first column of Sheet 1, from row 5 onward.\n - `A1:B2` refers to all the cells in the first two rows and columns of the first visible sheet.\n - `Sheet1` refers to all the cells in Sheet1.\n - `'Jon's_Data'!A1:D5` refers to all the cells in the first five rows and four columns of a sheet named \"Jon's_Data.\"\n - `'My Custom Sheet'!A:A` refers to all the cells in the first column of a sheet named \"My Custom Sheet.\"\n - `'My Custom Sheet'` refers to all the cells in \"My Custom Sheet\".\n\n Single quotes are required for sheet names with spaces or special characters.\n\n **Tip** : Where possible, use distinct names for objects in your spreadsheets. For example, A1 (without quotes) refers to cell A1 in the first visible sheet. `'A1'` refers to a sheet with the name A1. Similarly, Sheet1 refers to a sheet with the name Sheet1. However, if there's a named range titled \"Sheet1\", then Sheet1 refers to the named range and `'Sheet1'` refers to the sheet.\n\n *R1C1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n row numbers and column numbers. This method is less common than A1 notation,\n but can be useful when referencing a range of cells relative to a given\n cell's position.\n - `Sheet1!R1C1:R2C2` refers to the first two cells in the top two rows of Sheet1.\n - `R1C1:R2C2` refers to the first two cells in the top two rows of the first visible sheet.\n - `Sheet1!R[3]C[1]` refers to the cell that is three rows below and one column to the right of the current cell.\n\n *Named range*\n : A defined cell or range of cells with a custom name to simplify references\n throughout an application. A\n [`FilterView`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#filterview)\n resource represents a named range.\n\n *Protected range*\n : A defined cell or range of cells that cannot be modified. A\n [`ProtectedRange`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#protectedrange)\n resource represents a protected range.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Develop on\n Google Workspace](/workspace/guides/get-started).\n\n- To learn how to configure and run a Sheets API app, try the\n [JavaScript quickstart](/workspace/sheets/api/quickstart/js)."]]
