Bu sayfada, Google Chat uygulamalarının Chat kullanıcılarını tanımlama veya belirtme yöntemleri açıklanmaktadır.
Aşağıdakilerin yapılabilmesi için Chat uygulamasında bir kullanıcı belirtilmesi gerekir:
- @ bir kullanıcıdan bahseden bir mesaj oluşturun.
- Kullanıcıları mevcut bir alana davet edin veya ekleyin ya da yeni bir alana ekleyin.
- Chat uygulaması ile belirli bir kullanıcı veya iki kullanıcı arasındaki doğrudan mesajları bulun.
- Kullanıcıların alandaki üyelik bilgilerini görme.
- Bir kullanıcıya özel mesaj gönderin.
Chat, kullanıcıları nasıl tanımlar?
Google Chat API, Chat'i kullanan her kullanıcı için bir User
kaynağı oluşturur. Aşağıda iki önemli User
alanı verilmiştir:
name
, kaynağınusers/{user}
biçimindeki kaynak adıdır. Burada{user}
, benzersiz ve sabit bir tanımlayıcıyı temsil eder.users/app
, çağrı yapan Chat uygulaması için takma ad olarak kullanılabilir.type
, kullanıcı türüdür. Bu tür, Chat'e kullanıcının Chat uygulaması mı yoksa bir kişi mi olduğunu bildirir. Chat uygulamaları için değerBOT
'dir. Kişiler için değerHUMAN
.
Google Chat API'ye yapılan çağrıda bir kullanıcıyı belirtme
Bir kullanıcı belirtmek üzere {user}
değeri için aşağıdaki değerleri kullanın:
Google Workspace kuruluşlarındaki kullanıcılar aşağıdaki yaklaşımlardan birini uygulayabilir:
- Chat API'deki
User
kaynağınınname
(ör.users/123456789
). - People API'de
resourceName
öğesininpeople/{person_id}
olduğu birPerson
kaynağının adı için{person_id}
. Örneğin, Chat API'dekiusers/123456789
, People API'dekipeople/123456789
ile aynı kişiyi temsil eder. - Directory API'deki bir
User
kaynağı içinid
(ör. Chat API'dekiusers/123456789
), Directory API'dekiusers/123456789
ile aynı kişiyi temsil eder.
- Chat API'deki
Harici bir Google Workspace kuruluşundaki veya Google Hesabı kullanan bir kullanıcı için e-posta takma adı (örneğin,
users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com
veyausers/EMAIL_USERNAME@gmail.com
) kullanın.
Etkileşim etkinliğinden kullanıcı tanımlama
Bir kullanıcının Chat uygulamasıyla her etkileşimde bulunulduğunda Chat, etkileşim ve kullanıcı hakkında bilgi içeren bir etkileşim etkinliği gönderir. Örneğin, bir kullanıcı bir mesajda Chat uygulamasından bahsettiğinde Chat uygulaması, mesajın ne olduğu ve kimin tarafından gönderildiği gibi etkileşim hakkında bilgi alır. Chat uygulamaları, Chat kaynaklarıyla ilgili bilgi alırken kullanıcıları referans alır.
Chat uygulamasıyla etkileşime giren kullanıcıyı tanımlamak için User
kaynağındaki name
özelliğinin değerini alın. Bu değeri Event.user.name
adresinden edinebilirsiniz.
Aşağıdaki JSON örneğinde, bir Chat uygulamasıyla etkileşimde kullanıcı kimliğinin beklenen biçimi gösterilmektedir:
{
...,
"user": {
"name": "users/12345678901234567890",
"displayName": "Sasha",
"avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
"email": "sasha@example.com"
}
}
Mesaj belirli bir etkileşim türüdür. Bir Chat uygulamasına mesaj gönderen kullanıcıyı tanımlamak için, aşağıdakilerden birini kullanarak User
kaynağında name
özelliğinin değerini alın: