Ringkasan Google Sheets API

Google Sheets API adalah antarmuka RESTful yang memungkinkan Anda membaca dan memodifikasi data {i>spreadsheet<i}. Penggunaan paling umum API ini mencakup hal-hal berikut tugas:

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

Berikut adalah daftar istilah umum yang digunakan dalam API ini:

Spreadsheet

Objek utama di Google Spreadsheet yang dapat berisi beberapa sheet, masing-masing dengan informasi terstruktur yang ada di dalam sel-sel. Spreadsheet resource mewakili setiap {i>spreadsheet<i} dan memiliki spreadsheetId, 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}. Sheet resource mewakili setiap {i>sheet <i}dan memiliki judul dan angka yang unik Nilai sheetId. 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 tersusun dalam baris kolom, dan dapat dikelompokkan sebagai rentang sel. CellData resource mewakili setiap sel, tetapi tidak memiliki nilai ID yang unik. Sebagai gantinya, baris dan kolom koordinat yang mengidentifikasi sel-sel tersebut.

Notasi A1
Sintaksis yang digunakan untuk menentukan sel atau rentang sel dengan string yang berisi nama {i>sheet<i} ditambah 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 semua sel dalam dua baris dan kolom pertama pada 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 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 mengacu pada semua sel di lima baris dan empat kolom pertama pada sheet yang bernama "Jon's_Data".
  • 'My Custom Sheet'!A:A merujuk pada semua sel di kolom pertama sheet yang bernama "My Custom Sheet".
  • 'My Custom Sheet' merujuk pada semua sel di "My Custom Sheet".

Tanda kutip tunggal diperlukan untuk nama sheet dengan spasi, karakter khusus, atau kombinasi alfanumerik.

Tips: Jika memungkinkan, gunakan nama yang berbeda untuk objek di spreadsheet Anda. Misalnya, A1 merujuk ke sel A1 di sheet pertama yang terlihat, sedangkan A1 merujuk pada semua sel dalam sheet 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 sheet.
Notasi R1C1
Sintaksis yang digunakan untuk menentukan sel atau rentang sel dengan string yang berisi nama {i>sheet<i} ditambah koordinat sel awal dan akhir menggunakan nomor baris dan nomor kolom. Metode ini kurang umum dibandingkan notasi A1, tetapi dapat berguna ketika mengacu pada rentang sel yang relatif terhadap posisi sel.

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 melalui aplikasi. FilterView referensi mewakili rentang bernama.
Rentang dilindungi
Sel atau rentang sel yang ditentukan yang tidak dapat diubah. J ProtectedRange referensi mewakili rentang dilindungi.