Halaman ini menyediakan ringkasan tentang cara menggunakan Google Chat API dan referensinya dokumentasi tambahan.
Google Chat API memiliki gRPC dan antarmuka REST, dan library klien yang mendukung keduanya. Secara opsional, jika {i>library<i} klien yang disediakan tidak memenuhi kebutuhan Anda, Anda dapat menulis yang menggunakan antarmuka gRPC atau REST.
Library klien
Cara yang direkomendasikan bagi sebagian besar developer untuk memanggil Google Chat API dengan dukungan resmi Library Klien Cloud untuk bahasa pilihan Anda, seperti Python, Java, atau Node.js.
Jika Anda membuat kode dengan Google Apps Script, gunakan Layanan Chat lanjutan alih-alih menginstal library klien.
Jenis, metode, dan nama kolom
Bergantung pada apakah Anda menggunakan library klien, gRPC, atau REST, jenisnya, metode, dan nama kolom untuk Google Chat API agak bervariasi:
- Library Klien Cloud diatur oleh layanan gRPC dan metodenya. Library Klien Google API diatur sebagai layanan yang berisi objek atau yang sesuai dengan resource REST, yang juga berisi resource metode.
- gRPC diatur berdasarkan layanan dan metodenya.
- REST disusun berdasarkan hierarki resource dan metodenya.
- Nama kolom gRPC menggunakan snake case.
- Nama kolom REST menggunakan camel case, meskipun layanan API akan menerima {i>camel case<i} atau {i>snake case<i}.
- Nama isian pustaka klien menggunakan {i> title case<i}, {i>camel case<i} atau {i>snake case<i}, tergantung pada nama mana yang idiomatis untuk bahasa tersebut.
Buffering protokol
Baik Anda menggunakan library klien, REST, atau gRPC, layanan yang mendasarinya adalah yang ditentukan menggunakan buffering protokol. Secara khusus, layanan menggunakan proto3.
Saat memanggil API, beberapa kolom permintaan atau respons dapat memerlukan atribut Anda pahami buffering protokol jenis yang sudah dikenal.
Selain itu, saat memanggil REST API, Perilaku nilai default untuk protokol buffer dapat mengakibatkan hilangnya bidang dalam respons JSON. Bidang-bidang ini ditetapkan ke nilai {i>default<i}, sehingga tidak disertakan dalam respons.
Versi API
Tersedia versi API berikut:
- v1: Stabil.
Pratinjau Developer
Dalam dokumentasi, Anda mungkin melihat metode atau kolom API yang hanya yang tersedia melalui Program Pratinjau Developer. Untuk menguji, melihat pratinjau, dan menawarkan masukan tentang fitur pratinjau terbaru, bergabunglah dengan Program Pratinjau Developer.