Sampel

Bagian ini menyajikan codelab yang dapat Anda gunakan untuk memahami Google Sheets API. Juga disediakan serangkaian contoh "resep" yang menunjukkan cara menerjemahkan tindakan Google Spreadsheet yang diinginkan ke dalam permintaan API.

Sering kali ada lebih dari satu cara untuk menyelesaikan tugas yang diberikan dengan API. Saat Anda memutuskan cara menangani tugas, perhatikan hal berikut:

  • Jika Anda perlu membaca atau menulis nilai sel, koleksi spreadsheets.values adalah pilihan yang lebih baik daripada koleksi spreadsheets. Antarmuka sebelumnya lebih mudah digunakan untuk operasi baca/tulis sederhana.

  • Jika memungkinkan, gunakan metode batch (spreadsheet.batchUpdate, spreadsheet.values.batchGet, dan spreadsheet.values.batchUpdate) untuk memaketkan beberapa permintaan menjadi satu panggilan metode. Penggunaan metode batch ini meningkatkan efisiensi karena:

    • Mengurangi overhead HTTP klien.
    • Mengurangi jumlah kueri yang dibuat.
    • Mengurangi jumlah revisi pada dokumen.
    • Pastikan atomitas semua perubahan dalam batch.

Resep

Contoh yang tercantum di bagian ini menunjukkan cara mengekspresikan tindakan umum di Spreadsheet sebagai permintaan Sheets API v4.

Contoh-contoh ini disajikan dalam bentuk permintaan HTTP dengan bahasa yang netral. Untuk mempelajari cara menerapkan protokol permintaan Sheets API dalam bahasa tertentu menggunakan library klien Google API, lihat panduan Membaca & menulis nilai sel dan Memperbarui spreadsheet.

Resep di bagian ini dibagi menjadi beberapa kategori berikut:

  • Bacaan dasar—Resep yang menunjukkan cara membaca nilai dari sheet.
  • Penulisan dasar—Resep yang menunjukkan cara menulis nilai ke sheet.
  • Pemformatan dasar—Resep yang menunjukkan cara mengubah tampilan sheet dan sel.
  • Diagram—Resep yang menunjukkan cara membuat dan mengubah diagram dalam sheet.
  • Pemformatan bersyarat—Resep yang menampilkan cara mengubah tampilan sel berdasarkan kondisi.
  • Operasi data—Resep yang menunjukkan cara membuat, memindahkan, dan memanipulasi data dalam spreadsheet.
  • Rentang terproteksi & bernama—Resep yang menampilkan cara membuat, memperbarui, dan menghapus rentang terproteksi dan bernama dalam spreadsheet.
  • Tabel pivot—Resep yang menunjukkan cara membuat tabel pivot di sheet.
  • Operasi baris &kolom—Resep yang menunjukkan cara menambahkan, menghapus, dan memindahkan baris dan kolom, serta memperbarui propertinya.
  • Operasi sheet—Resep yang menunjukkan cara membuat, menghapus, menyalin, dan menghapus sheet, serta mengontrol propertinya.