Halaman ini memberikan ringkasan cara menggunakan Google Chat API dan dokumentasi referensinya.
Google Chat API memiliki antarmuka gRPC dan REST, serta library klien yang mendukung keduanya. Secara opsional, jika library klien yang disediakan tidak memenuhi kebutuhan Anda, Anda dapat menulis library klien sendiri yang menggunakan antarmuka gRPC atau REST.
Library klien
Cara yang direkomendasikan bagi sebagian besar developer untuk memanggil Google Chat API adalah dengan Library Klien Cloud yang didukung secara resmi untuk bahasa pilihan Anda, seperti Python, Java, atau Node.js.
Jika Anda membuat kode dengan Google Apps Script, gunakan layanan Chat Lanjutan daripada menginstal library klien.
Nama jenis, metode, dan kolom
Bergantung pada apakah Anda menggunakan library klien, gRPC, atau REST, jenis, metode, dan nama kolom untuk Google Chat API sedikit berbeda:
- Library Klien Cloud disusun berdasarkan layanan gRPC dan metodenya. Library Klien Google API disusun sebagai layanan yang berisi objek atau class yang sesuai dengan resource REST, yang juga berisi metode yang sesuai.
- gRPC disusun berdasarkan layanan dan metodenya.
- REST diatur berdasarkan hierarki resource dan metodenya.
- Nama kolom gRPC menggunakan snake case.
- Nama kolom REST menggunakan camel case, meskipun layanan API akan menerima camel case atau snake case.
- Nama kolom library klien menggunakan title case, camel case, atau snake case, bergantung pada nama yang idiomatis untuk bahasa tersebut.
Buffering protokol
Baik Anda menggunakan library klien, REST, atau gRPC, layanan yang mendasarinya ditentukan menggunakan protocol buffer. Secara khusus, layanan menggunakan proto3.
Saat memanggil API, beberapa kolom permintaan atau respons dapat memerlukan pemahaman dasar tentang jenis standar buffer protokol.
Selain itu, saat memanggil REST API, perilaku nilai default untuk buffer protokol dapat menyebabkan kolom tidak ada dalam respons JSON. Kolom ini ditetapkan ke nilai default, sehingga tidak disertakan dalam respons.
Versi API
Versi API berikut tersedia:
- v1: Stabil.
Pratinjau Developer
Dalam dokumentasi, Anda mungkin melihat metode atau kolom API yang hanya tersedia melalui Program Pratinjau Developer. Untuk menguji, melihat pratinjau, dan memberikan masukan tentang fitur pratinjau terbaru, bergabunglah ke Program Pratinjau Developer.