Sampel

Bagian ini menampilkan codelab yang dapat digunakan untuk memahami Google Sheets API. Bagian ini juga berisi contoh "resep" yang menunjukkan cara menerjemahkan tindakan Google Spreadsheet yang dimaksud ke dalam permintaan API.

Sering kali ada lebih dari satu cara untuk menyelesaikan tugas tertentu menggunakan API. Saat Anda memutuskan cara pendekatan terhadap tugas, perhatikan hal-hal berikut:

  • Jika Anda perlu membaca atau menulis nilai sel, koleksi spreadsheets.values adalah pilihan yang lebih baik daripada koleksi spreadsheets. Antarmuka former 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 ke dalam satu panggilan metode. Menggunakan metode batch ini akan meningkatkan efisiensi karena:

    • Mengurangi overhead HTTP klien.
    • Kurangi jumlah kueri yang dibuat.
    • Kurangi jumlah revisi di dokumen.
    • Pastikan atomisitas semua perubahan dalam batch.

Urutan langkah

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

Contoh ini ditampilkan dalam bentuk permintaan HTTP untuk menjadi netral bahasa. Untuk mempelajari cara menerapkan protokol permintaan Sheets API dalam bahasa tertentu menggunakan library klien Google API, lihat panduan Membaca & menulis nilai sel dan Mengupdate 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.
  • Format dasar—Resep yang menunjukkan cara mengubah tampilan sheet dan sel.
  • Diagram—Resep yang menunjukkan cara membuat dan mengubah diagram dalam sheet.
  • Format bersyarat—Resep yang menunjukkan cara mengubah tampilan sel berdasarkan kondisi.
  • Operasi data—Resep yang menunjukkan cara membuat, memindahkan, dan memanipulasi data dalam spreadsheet.
  • Rentang bernama & dilindungi—Resep yang menunjukkan cara membuat, mengupdate, dan menghapus rentang bernama dan dilindungi di spreadsheet.
  • Tabel pivot—Resep yang menunjukkan cara membuat tabel pivot dalam sheet.
  • Operasi baris & kolom—Resep yang menunjukkan cara menambahkan, menghapus, dan memindahkan baris serta kolom, serta memperbarui propertinya.
  • Operasi sheet—Resep yang menunjukkan cara membuat, menghapus, menyalin, dan menghapus sheet, serta mengontrol propertinya.