Contoh

Bagian ini menyajikan codelab Anda dapat gunakan untuk membiasakan diri dengan Google Sheets API. Disediakan juga serangkaian "resep" contoh yang menunjukkan cara menerjemahkan Google Spreadsheet yang dimaksud tindakan ini menjadi permintaan API.

Sering kali ada lebih dari satu cara untuk menyelesaikan tugas yang diberikan dengan API. Kapan Anda sedang memutuskan cara mendekati suatu tugas, ingatlah hal berikut:

  • Jika Anda perlu membaca atau menulis nilai sel, spreadsheets.values adalah pilihan yang lebih baik daripada Koleksi spreadsheets. Tujuan versi pertama 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. Dengan menggunakan batch ini metode tersebut meningkatkan efisiensi karena:

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

Resep

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

Contoh ini disajikan dalam bentuk permintaan HTTP untuk memilih bahasa netral. Untuk mempelajari cara mengimplementasikan protokol permintaan Sheets API di bahasa tertentu menggunakan library klien Google API, lihat referensi tulis sel nilai dan Perbarui spreadsheet.

Resep di bagian ini dibagi menjadi beberapa kategori berikut:

  • Bacaan dasar—Resep yang menunjukkan cara membaca nilai dari {i>sheet<i}.
  • Penulisan dasar—Resep yang menunjukkan cara menulis nilai ke sebuah {i>sheet<i}.
  • Pemformatan dasar—Resep yang ditampilkan cara mengubah tampilan {i>sheet<i} dan sel.
  • Diagram—Resep yang menunjukkan cara membuat dan mengubah bagan dalam sebuah {i>sheet<i}.
  • Bersyarat pemformatan—Resep yang menunjukkan cara mengubah tampilan sel berdasarkan kondisi.
  • Operasi data—Resep yang menunjukkan cara membuat, memindahkan, dan memanipulasi data di {i>spreadsheet<i}.
  • Bernama & rentang dilindungi—Resep yang menunjukkan cara membuat, memperbarui, dan menghapus rentang bernama dan dilindungi dalam {i>spreadsheet<i}.
  • Tabel pivot—Resep yang menunjukkan caranya untuk membuat tabel pivot dalam sebuah {i>sheet<i}.
  • Baris & operasi kolom—Resep yang menunjukkan cara menambah, menghapus, dan memindahkan baris dan kolom, serta memperbarui properti baru.
  • Operasi sheet—Resep yang menunjukkan cara membuat, membersihkan, menyalin, dan menghapus lembar, serta mengontrol propertinya.