Bu sayfada, Google Chat API'nin nasıl kullanılacağı ve referans dokümanları hakkında genel bilgiler verilmektedir.
Google Chat API'de hem gRPC hem de REST arayüzleri ve her ikisini de destekleyen istemci kitaplıkları bulunur. İsteğe bağlı olarak, sağlanan istemci kitaplıkları ihtiyaçlarınızı karşılamıyorsa gRPC veya REST arayüzünü kullanan kendi istemci kitaplıklarınızı yazabilirsiniz.
İstemci kitaplıkları
Çoğu geliştiricinin Google Chat API'yi çağırmak için önerilen yolu, Python, Java veya Node.js gibi tercih ettiğiniz dildeki resmi olarak desteklenen Cloud İstemci Kitaplıklarımızı kullanmaktır.
Google Apps Komut Dosyası ile kod yazıyorsanız istemci kitaplığı yüklemek yerine Advanced Chat hizmetini kullanın.
Tür, yöntem ve alan adları
İstemci kitaplıkları, gRPC veya REST kullanıp kullanmadığınıza bağlı olarak Google Chat API'nin türü, yöntemi ve alan adları biraz farklılık gösterir:
- Cloud İstemci Kitaplıkları, gRPC hizmetlerine ve yöntemlerine göre düzenlenir. Google API istemci kitaplıkları, REST kaynaklarına karşılık gelen nesneler veya sınıflar içeren hizmetler olarak düzenlenir. Bu hizmetler, karşılık gelen yöntemleri de içerir.
- gRPC, hizmetlere ve yöntemlerine göre düzenlenir.
- REST, kaynak hiyerarşilerine ve yöntemlerine göre düzenlenir.
- gRPC alan adlarında snake case kullanılır.
- REST alan adlarında camel case kullanılır ancak API hizmeti camel case veya snake case'i kabul eder.
- İstemci kitaplığı alan adları, dile özgü olan ada bağlı olarak başlık düzeni, camel case veya snake case kullanır.
Protokol arabellekleri
İstemci kitaplıkları, REST veya gRPC kullanıyor olsanız da temel hizmet protokol arabellekleri kullanılarak tanımlanır. Hizmet özellikle proto3'ü kullanır.
API çağrısı yaparken bazı istek veya yanıt alanları için protocol buffer well-known types hakkında temel bilgi sahibi olmak gerekebilir.
Ayrıca, REST API'yi çağırırken protokol arabellekleri için varsayılan değer davranışı, JSON yanıtında alanların eksik olmasına neden olabilir. Bu alanlar varsayılan değere ayarlandığından yanıta dahil edilmez.
API sürümleri
Aşağıdaki API sürümleri kullanılabilir:
- v1: Kararlı.
Geliştirici Önizlemesi
Belgelerde, yalnızca geliştirici önizleme programı aracılığıyla kullanılabilen API yöntemleri veya alanlar görebilirsiniz. En yeni önizleme özelliklerini test edip önizlemek ve bu özelliklerle ilgili geri bildirimde bulunmak için Geliştirici Önizleme Programı'na katılın.