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çıklanmıştır. Bu API sayesinde Chat uygulamaları alan oluşturma, alana kişi ekleme ve Chat uygulaması etkileşim etkinliği sormadan mesaj yayınlama gibi işlemleri yapabilir.

Kimlik doğrulama

Chat API'nin eşzamansız olarak çağrılması için kimlik doğrulama gerekir. Her Chat API yöntemi, kullanıcı kimlik doğrulaması (kullanıcı adına işlem gerçekleştirmek veya verilere erişmek için) ya da uygulama kimlik doğrulaması (işlem gerçekleştirmek veya Chat uygulaması olarak 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ğrulamasına genel bakış başlıklı makaleyi inceleyin.

API kaynakları ve yöntemleri

REST kaynakları ve yöntemleri Chat alanlarına, alan üyelerine, mesajlara, mesaj tepkilerine ve mesaj eklerine eşzamansız 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), iki kullanıcı veya bir kullanıcı ile bir Chat uygulaması arasındaki bire bir görüşmelerdir. Grup sohbetleri, üç 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ışma yaptığı kalıcı yerlerdir.

spaces kaynağı bir alanı temsil eder.

Alanlar aşağıdaki yöntemleri destekler:

Üyeler

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

spaces.members kaynağı bir üyeyi temsil eder.

Üyeler aşağıdaki yöntemleri destekler:

Mesajlar

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

spaces.messages kaynağı bir mesajı temsil eder.

Mesajlar aşağıdaki yöntemleri destekler:

Tepkiler

Tepkiler, kullanıcıların mesajlara tepki vermek için kullandıkları 👍, 🚲 ve 🌞 gibi emojileri temsil eder.

spaces.messages.reactions kaynağı bir tepkiyi temsil eder.

Tepkilerle aşağıdaki yöntemler desteklenir:

Medya ve ekler

Medya, Google Chat'e yüklenen resimler, videolar ve dokümanlar gibi bir dosyayı temsil eder.

media kaynağı, mesajlara bağlı medyayı temsil eder.

Ekler, iletilere eklenmiş medya (dosya) örnekleridir.

spaces.messages.attachments kaynağı bir eki temsil eder. Bir ek, bir iletiye eklenmiş medyayı ve ilişkili meta verileri içerir.

Medya ve ekler aşağıdaki yöntemleri destekler:

Alan etkinlikleri

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

spaces.spaceEvent kaynağı bir alan etkinliğini temsil eder.

Alan etkinlikleri aşağıdaki yöntemleri destekler:

Kullanıcının okuma durumları (Geliştirici Önizlemesi)

Kullanıcı okuma durumları, belirli bir kullanıcının Google Chat alanında veya bir mesaj dizisinde son okunan mesajıyla ilgili ayrıntıları temsil eden tekil kaynaklardır.

users.spaces kaynağı, kullanıcının bir alandaki okuma durumunu temsil eder.

users.spaces.threads kaynağı, kullanıcının bir mesaj dizisindeki okuma durumunu temsil eder.

Kullanıcı okuma durumları aşağıdaki yöntemleri destekler: