Bu sayfada, bir Google Chat uygulamasının Google Workspace Events API'yi kullanarak abone olabiliyor. Hangi projenin etkinlik türlerini görmek için bir aboneliği almaya başlayabilirsiniz. Google Chat'teki etkinlikler.
Etkinliklere abone olmanın yanı sıra Chat API'yi kullanabilirsiniz. Chat API'yi çağırmak şunları sağlar: düzenli olarak aldığınız etkinlikler oluyor veya bir abonelikteki kesintiler nedeniyle kaçırmış olabileceğiniz etkinlikler için geçerlidir. Öğrenmek için Chat etkinliklerini alma ve yanıtlama yöntemleri hakkında Google Chat'ten alınan etkinliklerle Chat dokümanları.
Desteklenen Chat etkinlikleri
Google Workspace abonelikleri, Chat'te aşağıdaki değişiklik türleri:
- Yeni, güncellenmiş veya silinmiş mesajlar sağlar.
- Yeni veya kaldırılmış tepkiler kısa açıklama ekleyin.
- Yeni, güncellenmiş veya kaldırılmış üyeler sağlar.
- Alanda yapılan değişiklikler (ör. güncellenmiş alan adı veya açıklaması) abone olduğunuz.
Etkinlikleri izleyebileceğiniz kaynaklar
Etkinlikleri almak için izlenecek bir Chat kaynağı belirtirsiniz ve Aboneliğin hedef kaynağı olarak adlandırılır.
Google Workspace Events API aşağıdaki hedef kaynakları destekler Sohbet için:
| Hedef kaynak | Biçim | Sınırlamalar |
|---|---|---|
| Boşluk |
burada SPACE,
Chat API |
Aboneliği yetkilendiren Chat kullanıcısı Google Workspace veya Google üzerinden alana üye olmak Hesap'a dokunun. |
| Bir kullanıcıya ait tüm alanlar |
|
Abonelik yalnızca kullanıcının şuralardaki etkinlikleri alır: Google Workspace veya Google Hesabı üzerinden üyelere. |
| Kullanıcı |
burada USER,
Chat API |
Abonelik yalnızca kullanıcı hakkında şu etkinlikleri alır: aboneliği yetkilendirdi. Kullanıcı, şurada bir aboneliği yetkilendiremez: diğer kullanıcılar adına da yapabilirsiniz. |
Abonelik oluşturmak için etkinlik türleri
Bir abonelik oluşturduğunuzda,
eventTypes[]
alanına, ne tür etkinlikler almak istediğinizi belirtebilirsiniz. Etkinlik türleri:
gibi CloudEvents spesifikasyonuna göre biçimlendirilmiştir;
google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
Örneğin, Chat'e katılan kullanıcılarla ilgili etkinlikleri almak için
alanı hedef kaynak olarak, etkinlik türünü ise
google.workspace.chat.membership.v1.created Belirli bir hakkındaki etkinlikleri almak için
bir alana katıldığını varsayalım. Kullanıcıyı hedef kaynak olarak belirtin ve
etkinlik türünü google.workspace.chat.membership.v1.created olarak belirleyin. Şu konu hakkında daha fazla bilgi edinmek için:
nasıl işlediğini öğrenmek için Google Workspace'in yapısına göz atın.
etkinlikler ile ilgili daha fazla bilgi edinin.
Aşağıdaki tabloda abonelikler için hangi etkinlik türlerinin desteklendiği gösterilmektedir alanlarla aboneliklere dönüştürmeyi öğrendiniz. Şunlarla ilgili istisnalar hakkında bilgi edinmek için: Sınırlamalar bölümüne bakın.
| Etkinlik türü | Biçim | Kaynak verileri | ||
|---|---|---|---|---|
| Alanlara abonelikler | ||||
| Bir mesaj gönderildi. |
|
|
||
| Bir mesaj güncellendi. |
|
|
||
| Bir mesaj silindi. |
|
|
||
| Bir tepki oluşturulur. |
|
|
||
| Tepki silindiğinde |
|
|
||
| Alana bir üye eklenir. |
|
|
||
| Alandaki bir üye güncellendi. |
|
|
||
| Alandan bir üye kaldırılır. |
|
|
||
| Alan güncellendi. |
|
|
||
| Alan silindi. |
|
|
||
| Kullanıcı abonelikleri | ||||
| Kullanıcı bir alanın üyesi olur.
Yeni üyelerin tümü etkinlikleri tetiklemez. Ayrıntılar için Sınırlamalar başlıklı makaleyi inceleyin. |
|
|
||
| Kullanıcının bir alan üyeliği güncellenir. |
|
|
||
| Kullanıcı bir alanın doğrudan üyesi olarak kaldırılır. |
|
|
||
Toplu etkinlik türleri (yalnızca çıkış)
Abone olduğunuz etkinlik türlerini almanın yanı sıra, Chat uygulaması da toplu etkinlikler alabilir. Toplu etkinlik Bir Shorts videosunda gerçekleşen aynı türden birçok etkinliği temsil eden etkinliktir tamamlanması gereken aktiviteleri ifade eder. Bir toplu etkinliğin yükü, değiştirilen tüm değişikliklerin bir listesini kaynaklar.
Örneğin bir kullanıcı bir alana aynı anda 20 kullanıcı eklediğinde
Chat uygulaması bir toplu etkinlik alabilir
(google.workspace.chat.membership.v1.batchCreated). Etkinlik yükü şunları içerir:
kullanıcı tarafından oluşturulan yeni Membership kaynaklarının tümünün
üyeleri alana ekledi.
Abone olduğunuz tüm etkinlik türleri için bir toplu etkinlik alırsınız.
bir abonelik oluşturduğunuzda toplu etkinlikleri belirtmeniz gerekmez. Örneğin,
Örneğin, yeni tepkilere abone olursanız
(google.workspace.chat.reaction.v1.created), sizin
Chat uygulaması, toplu e-posta gönderip alacak şekilde otomatik olarak yapılandırıldı
reaksiyon etkinlikleri (google.workspace.chat.reaction.v1.batchCreated).
Aşağıdaki tabloda bir abonelik için olası toplu etkinlikler gösterilmektedir:
| Toplu etkinlik türü | Biçim |
|---|---|
| Birden çok mesaj yayınlanır. |
|
| Birden fazla mesaj güncellendi. |
|
| Birden fazla mesaj silinir. |
|
| Birden fazla tepki oluşturulur. |
|
| Birden fazla tepki silinir. |
|
| Abone olunan alana birden çok üye veya abone olan kullanıcı birden fazla alana eklendi. |
|
| Abone olunan alanda veya abone olan kullanıcı için birden fazla üyelik güncellenir. |
|
| Abone olunan alandan birden fazla üye veya abone olan kullanıcı birden fazla alandan çıkarıldı. |
|
| Alanda birden fazla güncelleme var. |
|
Etkinlik verileri
Bu bölümde, aşağıdaki konumlardaki etkinliklerin etkinlik verileri ve örnek yükleri açıklanmaktadır: Sohbet.
Google Workspace aboneliğiniz şuradan bir etkinlik aldığında:
Sohbet,
data
alanı, etkinliğe ilişkin yükü içerir. Bu yük,
Değişen Google Workspace kaynağı. Örneğin,
bir uzayda üyelik etkinlikleri varsa bu etkinliklerin yükü,
hakkında
spaces.membership
bir kaynaktır.
Etkinlik yükündeki kaynak verileri
Bir abonelik oluştururken yükün abonelikten{/1} kaynakla ilgili ayrıntıları ya da yalnızca kaynağın adını içermelidir. Örneğin, Örneğin, bir Chat'te üyelerle ilgili etkinlikleri almak istiyorsanız bir üyelik kaynağının hangi alanlarını almak istediğinizi yardımcı olur.
Aşağıdaki tabloda, bir aboneliğin JSON yüküyle ilgili örnekler verilmiştir
Chat alanı spaces/AAAABBBBBB. Her etkinlik için
abonelik aldığında yük etkinliğin data alanında görünür:
| Örnek | Etkinlik türü | JSON yükü |
|---|---|---|
Bir kullanıcı, alanda "Merhaba dünya" mesajını yayınlar. |
|
Kaynak verileri içerir
{
"message":
{
"name": "spaces/AAAABBBBBB/messages/CCCCCCCCC.DDDDDDDDD",
"sender":
{
"name": "users/1234567890987654321",
"type": "HUMAN"
},
"createTime": "2023-09-07T21:37:36.260127Z",
"text": "Hello world",
"thread":
{
"name": "spaces/AAAABBBBBB/threads/EEEEEEEEEEEE"
},
"space":
{
"name": "spaces/AAAABBBBBB"
},
"argumentText": "Hello world"
}
}
Kaynak verileri hariçtir
{
"message":
{
"name": "spaces/AAAABBBBBB/messages/CCCCCCCCC.DDDDDDDDD"
}
}
|
| Kullanıcı, alan yöneticisi olur. |
|
Kaynak verileri içerir
{
"membership":
{
"name": "spaces/AAAABBBBBB/members/1234567890987654321",
"state": "JOINED",
"member":
{
"name": "users/1234567890987654321",
"type": "HUMAN"
},
"createTime": "1970-01-01T00:00:00Z",
"role": "ROLE_MANAGER"
}
}
Kaynak verileri hariçtir
{
"membership":
{
"name": "spaces/AAAABBBBBB/members/1234567890987654321"
}
}
|
| Bir kullanıcı, alanın açıklamasını "Cymbal Labs Satış Ekibi" olarak güncelliyor. | google.workspace.chat.space.v1.updated |
Kaynak verileri içerir
{
"space":
{
"name": "spaces/AAAABBBBBB",
"displayName": "Cymbal Sales",
"spaceThreadingState": "THREADED_MESSAGES",
"spaceType": "SPACE",
"spaceDetails":
{
"description": "Sales team for Cymbal Labs."
},
"spaceHistoryState": "HISTORY_ON"
}
}
Kaynak verileri hariçtir
{
"space":
{
"name": "spaces/AAAABBBBBB"
}
}
|
| Alana aynı anda iki Chat kullanıcısı eklendi. | google.workspace.chat.membership.v1.batchCreated |
Kaynak verileri içerir
{
"memberships": [
{
"membership": {
"name": "spaces/AAAABBBBBB/members/1234567890987654321",
"state": "JOINED",
"member":
{
"name": "users/1234567890987654321",
"type": "HUMAN"
},
"createTime": "1970-01-01T00:00:00Z",
"role": "ROLE_MEMBER"
}
},
{
"membership": {
"name": "spaces/AAAABBBBBB/members/987654321234567890",
"state": "JOINED",
"member":
{
"name": "users/987654321234567890",
"type": "HUMAN"
},
"createTime": "1970-01-01T00:00:00Z",
"role": "ROLE_MEMBER"
}
}
]
}
Kaynak verileri hariçtir
{
"memberships": [
{
"membership": {
"name": "spaces/AAAABBBBBB/members/1234567890987654321"
}
},
{
"membership": {
"name": "spaces/AAAABBBBBB/members/98765432123456789019"
}
}
]
}
|
| Bir kullanıcı, mesaja etkileşim emojisiyle tepki veriyor. | google.workspace.chat.reaction.v1.created |
Kaynak verileri içerir
{
"reaction":
{
"name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222",
"user":
{
"name": "users/1234567890987654321",
"type": "HUMAN"
},
"emoji":
{
"unicode": "😊"
}
}
}
Kaynak verileri atlanır
{
"reaction":
{
"name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222"
}
}
|
| Kullanıcılar bir mesaja alan emojileri ve 😸 emojileriyle tepki verir. | google.workspace.chat.reaction.v1.batchCreated |
Kaynak verileri içerir
{
"reactions": [
{
"reaction": {
"name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222",
"user":
{
"name": "users/1234567890987654321",
"type": "HUMAN"
},
"emoji":
{
"unicode": "😊"
}
}
},
{
"reaction": {
"name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/3333333333333333.444444444444444",
"user":
{
"name": "users/98765431234564321",
"type": "HUMAN"
},
"emoji":
{
"unicode": "😸"
}
}
}
]
}
Kaynak verileri atlanır
{
"reactions": [
{
"reaction": {
"name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222"
},
"reaction": {
"name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/3333333333333333.444444444444444",
}
}
]
}
|
Sınırlamalar
-
Kullanıcı abonelikleri için doğrudan mesajlardaki veya adsız grup sohbetlerindeki yeni üyelerle ilgili etkinlikler (
google.workspace.chat.membership.v1.created), yalnızca ilk mesaj yayınlandıktan sonra tetiklenir. - Üyelik etkinliklerini almak için kullanıcının alanın doğrudan üyesi olması gerekir. Kullanıcı eklendiyse bir Google Grubu aracılığıyla dolaylı olarak bir alana güncellendiğinde veya ekleyebilirsiniz. Google Grubu üyeliklerinin işleyiş şeklini öğrenmek için şu makaleyi inceleyin: Alanlara Google Grubu ekleyin.
İlgili konular
- Google Workspace etkinliklerinin yapısı
- OAuth kapsamlarını seçin
- Şuna abonelik oluşturun: Chat etkinliklerini alma