Google Chat API'ye genel bakış

Bu bölümde, bir Google Chat uygulamasının Chat API'yi nasıl çağırabileceği açıklanmaktadır. Chat API, Chat uygulamalarının alan oluşturma, alana kullanıcı ekleme ve mesaj yayınlama gibi işlemleri yapmasına olanak tanır.

Kimlik doğrulama

Chat API'yi çağırmak için kimlik doğrulama gerekir. Her Chat API yöntemi için kullanıcı kimlik doğrulaması (kullanıcı adına işlem yapmak veya verilere erişmek için) ya da uygulama kimlik doğrulaması (Chat uygulaması olarak işlem yapmak veya verilere erişmek için) gerekir. Bazı yöntemler hem kullanıcı kimlik doğrulamasını hem de uygulama kimlik doğrulamasını destekler.

Chat'te kimlik doğrulama hakkında daha fazla bilgi edinmek için Kimlik doğrulamaya genel bakış başlıklı makaleyi inceleyin.

İ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 istemci 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.

Google Chat API kavramları

gRPC hizmetleri veya REST kaynakları ve yöntemleri, Chat alanlarına, alan üyelerine, mesajlara, mesaj tepkilerine, mesaj eklerine, alan etkinliklerine ve kullanıcı okuma durumlarına erişim izni verir.

Alanlar

Alanlar, kullanıcıların ve uygulamaların sohbet edip dosya paylaşabileceği yerlerdir. Birkaç tür alan vardır. Doğrudan mesajlar (DM'ler), iki kullanıcı veya bir kullanıcı ile Chat uygulaması arasında yapılan bire bir görüşmelerdir. Grup sohbetleri ise üç veya daha fazla kullanıcı ile Chat uygulamaları arasında yapılan görüşmelerdir. Adlandırılmış alanlar, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalıştığı kalıcı yerlerdir.

Kaynak referansı:

Örnek kullanım için şu makaleye bakın:

Üyeler

Üyeler, alana katılan veya davet edilen kullanıcılar ve Chat uygulamalarıdır.

Kaynak referansı:

Örnek kullanım için şu makaleye bakın:

Mesajlar

Mesajlar, alanlarda yayınlanan metin ve kart iletişimlerini içerir. İletilere dosya eklenebilir. Kullanıcılar, mesajlara emoji ekleyerek tepki verebilir.

Kaynak referansı:

Örnek kullanım için şu makaleye bakın:

Tepkiler

Tepkiler, kullanıcıların bir mesaja tepki vermek için kullandığı emojileri (ör. 👍, 🚲 ve 🌞) temsil eder.

Kaynak referansı:

Örnek kullanım için şu makaleye bakın:

Özel emoji (geliştirici önizlemesi)

Özel emojiler, Google Chat'te kuruluş içinde oluşturulup paylaşılan özel emojileri temsil eder. Özel emojiler, bir mesajın içeriğine dahil edilebilir veya bir mesaja tepki vermek için kullanılabilir.

Kaynak referansı:

Medya ve ekler

Medya, Google Chat'e yüklenen resim, video ve doküman gibi bir dosyayı temsil eder.

Medya kaynağı referansı (RPC'de kullanılamaz):

Ekler, iletilere eklenen medya öğelerinin (dosyaların) örnekleridir.

Kaynak referansı:

Örnek kullanım için şu makaleye bakın:

Alan etkinlikleri

Alan etkinlikleri, bir alanda veya alt kaynaklarında (üyeler, mesajlar ve tepkiler dahil) yapılan değişiklikleri temsil eder.

Kaynak referansı:

Örnek kullanım için şu makaleye bakın:

Kullanıcı okuma durumları

Kullanıcı okuma durumları, belirli bir kullanıcının Google Chat alanındaki veya mesaj ileti dizisindeki son okuduğu mesajla ilgili ayrıntıları temsil eden tekil kaynaklardır.

Alan okuma durumu kaynak referansı:

Mesaj dizisi okuma durumu kaynak referansı:

Örnek kullanım için şu makaleye bakın:

Kullanıcı alanı bildirim ayarları (geliştirici önizlemesi)

Kullanıcı alanı bildirim ayarları, Google Chat alanındaki belirli kullanıcı bildirim ayarlarını temsil eden tekil kaynaklardır.

Kaynak referansı:

Chat uygulamaları, Chat API'yi çağırmanın yanı sıra şunları da yapabilir: