Ringkasan Google Sheets API

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, masing-masing dengan informasi terstruktur yang terdapat dalam Cells. Resource spreadsheets mewakili spreadsheet. Properti ini berisi nilai spreadsheetId unik.

ID Spreadsheet
ID unik untuk spreadsheet. Ini adalah string tertentu yang berisi huruf, angka, dan beberapa karakter khusus yang mereferensikan spreadsheet dan dapat berasal 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
Sheet

Halaman atau tab dalam spreadsheet. Resource Sheets mewakili sheet. Objek ini berisi nilai sheetId numerik unik dan sheet title sebagai bagian dari objek SheetProperties.

ID Sheet
ID unik untuk sheet tertentu dalam spreadsheet. Ini adalah string tertentu yang berisi huruf, angka, dan beberapa karakter khusus yang mereferensikan sheet dan dapat berasal dari URL spreadsheet. ID sheet bersifat stabil, meskipun nama sheet berubah. Untuk contoh, lihat ID Spreadsheet.
Sel

Setiap kolom teks atau data 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.

Tampilkan contoh

  • 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 kolom pertama Sheet 1, dari baris 5 dan seterusnya.
  • A1:B2 mengacu pada semua sel di dua baris dan kolom pertama dari sheet pertama yang terlihat.
  • Sheet1 mengacu pada semua sel di Sheet1.
  • 'Jon's_Data'!A1:D5 merujuk ke semua sel di lima baris pertama dan empat kolom pada sheet bernama "Jon's_Data".
  • 'My Custom Sheet'!A:A mengacu pada semua sel di kolom pertama sheet bernama "Sheet Kustom Saya".
  • 'My Custom Sheet' mengacu pada semua sel di "Sheet Kustom Saya".

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 (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 berjudul "Sheet1", Sheet1 akan merujuk ke rentang bernama dan 'Sheet1' akan 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 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 mengacu pada dua sel pertama di dua baris atas 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.