Google Sheets API adalah antarmuka RESTful yang dapat Anda gunakan untuk membaca dan mengubah data spreadsheet. Penggunaan paling umum API ini mencakup tugas-tugas berikut:
- Buat spreadsheet
- Membaca dan menulis nilai sel {i>spreadsheet<i}
- Perbarui format spreadsheet
- Mengelola Sheet yang Terhubung
Di bawah ini adalah daftar istilah umum yang digunakan dalam Sheets API:
- Spreadsheet
Objek utama di Google Spreadsheet yang dapat berisi beberapa sheet, masing-masing dengan informasi terstruktur yang terkandung dalam sel. Resource spreadsheet mewakili setiap spreadsheet dan memiliki nilai
spreadsheetId
unik, yang berisi huruf, angka, tanda hubung, atau garis bawah. Anda dapat menemukan ID spreadsheet di URL Google Spreadsheet:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
- Sheet
Sebuah halaman atau tab dalam {i>spreadsheet<i}. Resource sheet mewakili setiap sheet dan memiliki judul yang unik serta nilai
sheetId
numerik. Anda dapat menemukan ID sheet di URL Google Spreadsheet:https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
- Sel
Kolom teks atau data individual dalam sheet. Sel tersusun dalam baris dan kolom, dan dapat dikelompokkan sebagai rentang sel. Resource CellData mewakili setiap sel, tetapi tidak memiliki nilai ID yang 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 ketika mengacu pada rentang sel absolut.
Tampilkan contoh
Sheet1!A1:B2
mengacu pada dua sel pertama di dua baris atas Sheet1.Sheet1!A:A
merujuk ke semua sel di kolom pertama Sheet1.Sheet1!1:2
mengacu pada semua sel dalam dua baris pertama Sheet1.Sheet1!A5:A
merujuk pada semua sel di kolom pertama Sheet 1, dari baris 5 dan seterusnya.A1:B2
merujuk pada dua sel pertama di dua baris atas sheet pertama yang terlihat.Sheet1
merujuk ke semua sel di Sheet1.'My Custom Sheet'!A:A
merujuk pada semua sel di kolom pertama sheet yang bernama "My Custom Sheet". Tanda kutip tunggal diperlukan untuk nama sheet dengan spasi, karakter khusus, atau kombinasi alfanumerik.'My Custom Sheet'
merujuk ke semua sel di 'Sheet Kustom Saya'.
Tips: Jika memungkinkan, gunakan nama yang berbeda untuk objek dalam spreadsheet Anda. Contohnya, A1 mengacu pada sel A1 di lembar pertama yang terlihat, sedangkan 'A1' mengacu pada semua sel dalam lembaran bernama A1. Demikian pula, Sheet1 mengacu pada semua sel di Sheet1. Namun, jika ada rentang bernama berjudul "Sheet1", Sheet1 akan mengacu pada rentang bernama dan 'Sheet1' mengacu pada 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 daripada notasi A1, tetapi dapat berguna saat mereferensikan rentang sel yang relatif terhadap posisi sel tertentu.
Tampilkan contoh
Sheet1!R1C1:R2C2
mengacu pada dua sel pertama di dua baris atas Sheet1.R1C1:R2C2
merujuk pada dua sel pertama di dua baris atas 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 telah ditentukan yang tidak dapat dimodifikasi. Resource ProtectedRange mewakili rentang dilindungi.
Langkah berikutnya
Untuk mempelajari cara mengembangkan aplikasi dengan Google Workspace API, termasuk menangani autentikasi dan otorisasi, lihat Mengembangkan aplikasi di Google Workspace.
Untuk mempelajari cara mengonfigurasi dan menjalankan aplikasi Sheets API sederhana, baca Ringkasan panduan memulai.