Ringkasan Google Sheets API

Google Sheets API adalah antarmuka RESTful yang memungkinkan Anda membaca dan mengubah data spreadsheet. Penggunaan API ini yang paling umum mencakup tugas berikut:

  • Membuat spreadsheet
  • Membaca dan menulis nilai sel {i>spreadsheet<i}
  • Perbarui pemformatan spreadsheet
  • Mengelola Sheet yang Terhubung

Di bawah ini adalah daftar istilah umum yang digunakan di Sheets API:

Spreadsheet

Objek utama di Google Spreadsheet yang dapat berisi beberapa sheet, masing-masing berisi informasi terstruktur yang terdapat 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

Halaman atau tab dalam {i>spreadsheet<i}. Resource sheet mewakili setiap sheet dan memiliki judul dan nilai numerik sheetId yang unik. Anda dapat menemukan ID sheet di URL Google Spreadsheet:

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

Sel

Satu kolom teks atau data dalam sheet. Sel diatur 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-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 paling umum dan berguna saat mereferensikan rentang sel absolut.

Tampilkan contoh

  • Sheet1!A1:B2 mengacu pada dua sel pertama di dua baris atas Sheet1.
  • Sheet1!A:A mengacu pada semua sel yang ada di kolom pertama Sheet1.
  • Sheet1!1:2 mengacu pada semua sel dalam dua baris pertama Sheet1.
  • Sheet1!A5:A mengacu pada semua sel di kolom pertama Spreadsheet 1, dari baris 5 dan seterusnya.
  • A1:B2 merujuk pada dua sel pertama di dua baris atas sheet pertama yang terlihat.
  • Sheet1 mengacu pada 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 pada semua sel di 'My Custom Sheet'.

Tips: Jika memungkinkan, gunakan nama yang berbeda untuk objek dalam spreadsheet Anda. Misalnya, A1 mengacu pada sel A1 di lembar pertama yang terlihat, sedangkan 'A1' mengacu pada semua sel dalam lembar bernama A1. Demikian pula, Sheet1 mengacu pada semua sel di Sheet1. Namun, jika ada rentang bernama "Sheet1", maka Sheet1 mengacu pada rentang bernama dan 'Sheet1' mengacu pada lembar.

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 terkait dengan 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 khusus untuk menyederhanakan referensi di seluruh aplikasi. FilterView resource mewakili rentang bernama.

Rentang dilindungi

Sel atau rentang sel yang ditentukan yang tidak dapat diubah. Resource ProtectedRange mewakili rentang dilindungi.

Langkah berikutnya