Bu sayfada Google Chat API ve Google Chat uygulamalarına genel bir bakış sunulmaktadır.
Google Chat API'ye genel bakış
Chat API, alanlar, alan üyeleri, mesajlar, mesaj tepkileri, mesaj ekleri, alan etkinlikleri ve kullanıcı okuma durumları dahil olmak üzere Chat'e erişim izni veren gRPC hizmetleri veya REST kaynakları ve yöntemlerinden oluşur.
Kavramlar
Aşağıdaki bölümde, Chat API'nin hizmetleri, kaynakları ve yöntemleri tanımlanmaktadır:
- Alanlar
Alanlar, kullanıcıların ve uygulamaların sohbet edebileceği ve dosya paylaşabileceği yerlerdir. Birkaç tür alan vardır. Doğrudan mesajlar (DM'ler), iki kullanıcı veya bir kullanıcı ile bir Chat uygulaması arasındaki bire bir görüşmelerdir. Grup sohbetleri ise üç veya daha fazla kullanıcı ile Chat uygulamaları arasındaki 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 bkz.:
- Üyeler
Üyeler, bir alana katılan veya davet edilen kullanıcılar ve Chat uygulamalarıdır.
Kaynak referansı:
Örnek kullanım için bkz.:
- Mesajlar
Mesajlar, alanlarda yayınlanan metin ve kart iletişimlerini içerir. İletilere dosya eklenebilir. Kullanıcılar, iletilere emoji ekleyerek tepki verebilir.
Kaynak referansı:
Örnek kullanım için bkz.:
- Tepkiler
Tepkiler, kullanıcıların mesajlara tepki vermek için kullandığı emojileri (ör. 👍, 🚲 ve 🌞) ifade eder.
Kaynak referansı:
Örnek kullanım için bkz.:
- Özel emoji
Özel emoji, Google Chat'te kuruluş içinde oluşturulan ve paylaşılan özel emojileri ifade eder. Özel emoji'ler mesaj içeriğine eklenebilir veya mesajlara tepki vermek için kullanılabilir.
Kaynak referansı:
- Medya ve ekler
Medya, Google Chat'e yüklenen resim, video ve doküman gibi dosyaları ifade eder.
Medya kaynağı referansı (RPC'de kullanılamaz):
Ekler, iletilere eklenen medya (dosya) örnekleridir.
Kaynak referansı:
Örnek kullanım için bkz.:
- Alan etkinlikleri
Alan etkinlikleri, alan veya alt kaynaklarında (üyeleri, mesajları ve tepkileri dahil) yapılan değişiklikleri gösterir.
Kaynak referansı:
Örnek kullanım için bkz.:
- Kullanıcı okuma durumları
Kullanıcı okuma durumları, bir Google Chat alanında veya ileti dizisinde belirtilen kullanıcının okuduğu son iletiyle ilgili ayrıntıları temsil eden tekil kaynaklardır.
Alan okuma durumu kaynak referansı:
İş parçacığı okuma durumu kaynak referansı:
Örnek kullanım için bkz.:
- Kullanıcı alanı bildirim ayarları
Kullanıcı alanı bildirim ayarları, Google Chat alanındaki belirli bir kullanıcı bildirim ayarlarını temsil eden tekil kaynaklardır.
Kaynak referansı:
Kimlik doğrulama
Chat API'yi çağırmak için kimlik doğrulama gerekir. Her Chat API yöntemi, kullanıcı kimlik doğrulaması (bir 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) gerektirir. 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ğı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.
Chat uygulamaları oluşturma
Chat API, hizmetlerinizi ve kaynaklarınızı doğrudan Google Chat'e getiren Google Chat uygulamaları oluşturmanıza olanak tanır. Aşağıdakilerden herhangi birini yapmak için sohbet uygulamaları oluşturabilirsiniz:
- Kullanıcı tarafından girilen yapılandırılmış veya serbest metin sorgularına göre bilgi alın.
- Kullanıcı tarafından sağlanan bilgileri kullanarak olay raporları veya başka yapay içerikler oluşturma.
- "Ekip hafızası" sağlama veya kaynak planlama gibi ekip iş birliğini geliştirebilirsiniz.
Chat uygulamanızı aşağıdaki gibi çeşitli mimari stiller kullanarak tasarlayabilirsiniz:
- Etkileşimli uygulamalar: @bahsetme veya eğik çizgi komutları gibi kullanıcı etkileşimlerine yanıt verin ve kartlar ile iletişim kutularıyla bilgi sunun veya kullanıcılara bir iş akışında yol gösterin.
- Komut satırı uygulamaları veya webhook'lar: Başka bir sistemden bir alana proaktif mesajlar (ör. alarmlar veya bildirimler) gönderin. Kullanıcılar bu tür uygulamalarla doğrudan etkileşimde bulunamaz.
- Etkinliğe dayalı uygulamalar: Bir Chat alanındaki etkinliklere (ör. yeni bir üyenin katılması) abone olun ve bu etkinliklere tepki verin. Uygulama, bir etkinliğe yanıt olarak mesaj gönderebilir veya başka bir işlem gerçekleştirebilir.
Chat uygulamanızı tasarlama hakkında ayrıntılı bilgi için Google Chat uygulama mimarisi seçme başlıklı makaleyi inceleyin.
İlgili konular
- Google Chat uygulama örneklerini inceleyin.
- Etkileşimli Google Chat uygulamaları oluşturun.
- Google Chat uygulaması mimarisi seçin.
Google Chat API'yi iş başında mı görmek istiyorsunuz?
Google Workspace Developers kanalında ipuçları, püf noktaları ve en yeni özelliklerle ilgili videolar yer alır.
|