Bu sayfada, Google Chat API'nin nasıl kullanılacağına ve referans dokümanlarına genel bir bakış sunulmaktadır.
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ğırması için önerilen yöntem, tercih ettiğiniz dil (ör. Python, Java veya Node.js) için 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 Gelişmiş Chat hizmetini kullanın.
Tür, yöntem ve alan adları
İstemci kitaplıklarını, gRPC'yi veya REST'i kullanıp kullanmadığınıza bağlı olarak Google Chat API'nin türü, yöntemi ve alan adları biraz değişiklik gösterir:
- Cloud İstemci Kitaplıkları, gRPC hizmetlerine ve bunların 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 ve ilgili yöntemleri de barındıran hizmetler olarak düzenlenir.
- gRPC, hizmetlere ve yöntemlerine göre düzenlenir.
- REST, kaynak hiyerarşileri ve yöntemlerine göre düzenlenir.
- gRPC alan adlarında küçük harf kullanılır.
- REST alan adlarında büyük/küçük harf kullanımı tercih edilir ancak API hizmeti büyük/küçük harf kullanımını veya küçük/küçük harf kullanımını kabul eder.
- İstemci kitaplığı alan adları, dil için hangi adın idiomatik olduğuna bağlı olarak büyük harf, küçük harf veya alt çizgi düzeninde kullanılır.
Protokol arabellekleri
İstemci kitaplıkları, REST veya gRPC kullanıyor olsanız da temel hizmet protokol arabellekleri kullanılarak tanımlanır. Özellikle, hizmet proto3'ü kullanır.
API'yi çağırırken bazı istek veya yanıt alanları için protokol arabelleğinin bilinen türleri hakkında temel düzeyde bilgi sahibi olmanız gerekebilir.
Ayrıca, REST API'yi çağırırken protokol arabelleklerinin varsayılan değer davranışı, JSON yanıtında eksik alanlara 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 son önizleme özelliklerini test etmek, önizlemek ve geri bildirimde bulunmak için Geliştirici Önizleme Programı'na katılın.