Bu bölümde, Google Chat uygulamalarının Chat API'yi nasıl çağırabileceği açıklanmaktadır. Bu API, Chat uygulamalarının alan oluşturma, alana kullanıcı ekleme ve Chat uygulaması etkileşim etkinliği tarafından istenmeden mesaj yayınlama gibi işlemleri yapmasına olanak tanır.
Kimlik doğrulama
Chat API'yi eşzamansız olarak çağırmak için kimlik doğrulama gerekir. Chat API yöntemlerinin her biri, 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ı (Chat uygulaması olarak işlem gerçekleştirmek 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.
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ürde 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, üç 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.
spaceskaynağı bir alanı temsil eder.Alanlar aşağıdaki yöntemleri destekler:
- Kullanıcıların ve uygulamaların dosya sohbet edip paylaşabileceği bir yer olan bir alan oluşturun.
- Bir alan oluşturup bu alana kullanıcılar ve Chat uygulamaları ekleyin.
- Bir alanla ilgili ayrıntıları görmek için alan satın alabilirsiniz.
- Alanların sayfalara ayrılmış ve 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 ihtiyaç duyulmayan alanları silebilirsiniz.
- İki kullanıcı arasındaki DM'yi veya bir kullanıcı ile arayan Chat uygulamaları arasındaki DM'yi döndürmek için doğrudan mesajları (DM) bulun.
- Üyeler
Üyeler, bir alana katılan veya alana davet edilen kullanıcılar ve Chat uygulamalarıdır.
spaces.memberskaynağı bir üyeyi temsil eder.Üyeler aşağıdaki yöntemleri destekler:
- Bir alana kullanıcı veya uygulama eklemek için üyelik oluşturun.
- Üyelikle ilgili ayrıntıları görmek için üyelik edinin.
- Üyelikleri listeleyerek bir alandaki üyeliklerin sayfalara ayrılmış ve filtrelenebilir bir listesini görebilirsiniz.
- Üyeliklerle ilgili özellikleri (ör. alan üyesini alan yöneticisi veya alan yöneticisi olarak değiştirme) değiştirmek için üyeliği güncelleyin.
- Alandan bir kullanıcı veya uygulama 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.messageskaynağı bir mesajı temsil eder.Mesajlar aşağıdaki yöntemleri destekler:
- Metin veya kart mesajı yayınlamak için bir mesaj oluşturun. Ayrıca bir mesaj dizisi başlatabilir veya mesaj dizisini yanıtlayabilirsiniz.
- Bir mesajla ilgili ayrıntıları (ör. ne zaman gönderildiği veya ne yazdığı gibi) almak için mesaj alabilirsiniz.
- Bir alandaki mesajların sayfalara ayrılmış ve filtrelenebilir bir listesini görmek için mesajları listeleyin.
- Söyledikleri gibi mesaj özelliklerini değiştirmek için bir mesajı güncelleyin. Ayrıca kart mesajlarına metin, kısa mesajlara da kart ekleyebilirsiniz.
- Artık ihtiyaç duymadığınız mesajları silebilirsiniz.
- Tepkiler
Tepkiler, kullanıcıların bir mesaja tepki vermek için kullandığı emojileri temsil eder. Örneğin: 👍, 🚲 ve 🌞.
spaces.messages.reactionskaynağı bir tepkiyi temsil eder.Tepkiler aşağıdaki yöntemleri destekler:
- Mesaja emoji eklemek için tepki oluşturun.
- Tepkileri listeleyerek bir mesaja verilen tepkilerin sayfalara ayrılmış ve filtrelenebilir bir listesini görebilirsiniz.
- Bir emojiyi mesajdan kaldırmak için tepkiyi silin.
- Medya ve ekler
Medya, Google Chat'e yüklenen resim, video ve dokümanlar gibi bir dosyayı temsil eder.
mediakaynağı, mesajlara ekli medyayı temsil eder.Ekler, iletilere ekli medya (dosyalar) örnekleridir.
spaces.messages.attachmentskaynağı bir eki temsil eder. Ek, bir mesaja ekli medyaları ve ilişkili meta verileri içerir.Medya ve ekler aşağıdaki yöntemleri destekler:
- Google Chat'e medya yüklemek ve ardından bir mesaja eklemek için ek olarak medya yükleyin.
- Google Chat'ten medya dosyası olarak indirmek için ek olarak medyayı indirin.
- İleti ekleriyle ilgili meta verileri almak için ek alma.
- Alan etkinlikleri
Alan etkinlikleri üyeler, mesajlar ve tepkiler dahil olmak üzere bir alanda veya alanın alt kaynaklarında yapılan değişiklikleri temsil eder.
spaces.spaceEventkaynağı 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 alan etkinliği alabilirsiniz.
- 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 bir Google Chat alanında veya mesaj ileti dizisinde son okunan mesajıyla ilgili ayrıntıları temsil eden tekil kaynaklardır.
users.spaceskaynağı, kullanıcının alandaki okuma durumunu temsil eder.users.spaces.threadskaynağı, bir mesaj dizisindeki kullanıcının okuma durumunu temsil eder.Kullanıcı okuma durumları aşağıdaki yöntemleri destekler:
- Alandaki bir kullanıcının okunma durumuyla ilgili ayrıntıları döndürmek için Alanın okunma durumunu al.
- Alandaki bir kullanıcının okuma durumunu güncellemek için alan okuma durumunu güncelleyin.
- Bir ileti dizisinde kullanıcının okuma durumuyla ilgili ayrıntıları döndürmek için ileti dizisi okuma durumunu alın.