Pengantar

API Google Docs memungkinkan Anda membuat dan memodifikasi dokumen.

Aplikasi dapat berintegrasi dengan Docs API untuk membuat dokumen yang disempurnakan dari data yang disediakan oleh pengguna dan sistem. API ini memungkinkan Anda untuk:

  • Mengotomatiskan proses
  • Membuat dokumentasi secara massal
  • Membuat invoice atau kontrak

Ringkasan API

Resource documents menyediakan metode yang Anda gunakan untuk memanggil Docs API.

Metode API

Metode berikut memungkinkan Anda membuat, membaca, dan memperbarui dokumen Google Dokumen:

Metode get dan batchUpdate memerlukan documentId (lihat di bawah) sebagai parameter untuk menentukan dokumen target. Metode create menampilkan instance dokumen yang dibuat, yang darinya Anda dapat membaca ID-nya.

Kumpulan update

Metode batchUpdate mengambil daftar objek permintaan, dan membuat pembaruan sesuai dengan urutan yang sama dengan saat muncul dalam permintaan batch. Update dalam batch update diterapkan secara atomik. Artinya, jika ada permintaan yang tidak valid, seluruh pembaruan akan gagal dan tidak ada satu pun perubahan (yang berpotensi bergantung) yang diterapkan.

Metode batchUpdate akan menampilkan daftar objek respons. Objek dalam daftar ini menempati urutan indeks yang sama dengan permintaan terkait.

Lihat praktik terbaik permintaan batch untuk mengetahui cara mengelompokkan panggilan API sekaligus dan dokumentasi referensi googleplay untuk jenis permintaan dan respons.

ID Dokumen

ID dokumen mereferensikan dokumen dan dapat berasal dari URL:

https://docs.google.com/document/d/documentId/edit

documentId adalah string unik yang berisi huruf, angka, dan beberapa karakter khusus. Ekspresi reguler berikut dapat digunakan untuk mengekstrak ID dokumen dari URL Google Dokumen:

/document/d/([a-zA-Z0-9-_]+)

Jika Anda sudah terbiasa dengan Google Drive API, documentId akan sesuai dengan ID resource File.

Lokasi dalam dokumen: indeks

Saat Anda membuat pembaruan pada isi dokumen, setiap pembaruan terjadi di suatu lokasi atau di seluruh rentang dalam dokumen. Lokasi dan rentang ini ditentukan menggunakan indeks, yang mewakili offset dalam segmen dokumen yang memuatnya. Untuk mempelajari indeks dan cara menggunakannya lebih lanjut, lihat panduan konsep Struktur dokumen Google Dokumen.

Alur kerja pembaruan dokumen

Membuat dan mengisi dokumen baru menjadi mudah, karena tidak ada konten yang perlu dikhawatirkan dan tidak ada kolaborator yang dapat mengubah status dokumen. Secara konseptual, ini berfungsi seperti yang ditunjukkan dalam diagram urutan berikut:

Alur kerja untuk membuat dan mengisi dokumen baru.

Memperbarui dokumen yang ada lebih rumit. Sebelum dapat melakukan panggilan yang berarti untuk memperbarui dokumen, Anda perlu mengetahui status dokumen saat ini: elemen apa saja yang menyusunnya, konten apa yang ada dalam elemen tersebut, dan lokasi semua item tersebut dalam dokumen. Diagram urutan berikut menunjukkan cara kerjanya:

Alur kerja untuk memperbarui dokumen.

Diagram ini tidak mempertimbangkan alur kerja saat pembaruan serentak oleh kolaborator lain dibuat dalam dokumen yang sama. Lihat Merencanakan kolaborasi untuk membahas topik ini.