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:
- Kullanıcıların ve uygulamaların sohbet edip dosya paylaşabileceği bir yer olan bir alan oluşturabilirsiniz.
- Bir alan oluşturup bu alana kullanıcılar ve Chat uygulamaları ekleyin.
- Bir alanla ilgili ayrıntıları görmek için alan alın.
- Alanların sayfalara ayrılmış, filtrelenebilir bir listesini görmek için alanları listeleyin.
- Bir alanla ilgili özellikleri (ör. kullanıcı tarafından görülebilen görünen ad, açıklama ve kurallar) değiştirmek için alanı güncelleyin.
- Artık gerekli olmayan alanları silebilirsiniz.
- İki kullanıcı arasındaki bir DM'yi veya bir kullanıcı ile arama yapan Chat uygulamaları arasındaki DM'yi geri döndürmek için doğrudan mesajı (DM) bul.
- Ü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:
- Bir alana kullanıcı veya uygulama eklemek için üyelik oluşturun.
- Bir üyelikle ilgili ayrıntıları görmek için üyelik edin.
- Üyelikleri listeleyerek bir alandaki üyeliklerin sayfalara ayrılmış ve filtrelenebilir bir listesini görebilirsiniz.
- Üyeliği güncelleyerek üyelikle ilgili özellikleri (ör. bir alan üyesini alan yöneticisi veya alan yöneticisi olarak değiştirme) değiştirmek için kullanabilirsiniz.
- Bir kullanıcıyı veya uygulamayı alandan kaldırmak için üyeliği silin.
- 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:
- Kısa mesaj veya kart mesajı yayınlamak için mesaj oluşturun. Ayrıca bir mesaj dizisi başlatabilir veya yanıtlayabilirsiniz.
- Bir mesajla ilgili ayrıntıları (ör. mesajın ne zaman gönderildiği veya ne söylediği) öğrenmek için mesaj alın.
- Bir alandaki mesajların sayfalara ayrılmış, filtrelenebilir bir listesini görmek için Mesajları listeleyin.
- Mesaj özelliklerini (ör. mesajın içeriği) değiştirmek için bir mesajı güncelleyin. Ayrıca kart mesajına metin veya kısa mesaja kart ekleyebilirsiniz.
- Artık gerekli olmayan mesajları silebilirsiniz.
- 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:
- Bir iletiye emoji eklemek için tepki oluşturun.
- Bir mesaja verilen tepkilerin sayfalandırılmış, filtrelenebilir bir listesini görmek için tepkileri listeleyin.
- Tepki silme: Bir emojiyi mesajdan kaldırabilirsiniz.
- 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:
- Medyayı ek olarak yükleyerek Google Chat'e medya yükleyin ve ardından bir mesaja ekleyin.
- Google Chat'ten medyayı ikili program dosyası olarak indirmek için medyayı ek olarak indirin.
- Bir mesaj ekiyle ilgili meta verileri almak için Ek al'ı tıklayın.
- 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:
- Bir alanda gerçekleşen bir etkinlikle ilgili ayrıntıları döndürmek için uzay etkinliği alın.
- Bir alanda gerçekleşen etkinliklerin listesini almak için alan etkinliklerini listeleyin.
- Kullanıcı okuma durumları
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:
- Alan okuma durumunu al: Kullanıcının bir alandaki okuma durumuyla ilgili ayrıntıları döndürür.
- Bir alandaki kullanıcının okuma durumunu güncellemek için alan okuma durumunu güncelleyin.
- İş parçacığı okuma durumunu al, bir kullanıcının ileti dizisi içindeki okuma durumuyla ilgili ayrıntıları döndürür.