Google Chat kullanıcılarını belirleme ve belirtme

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:

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ğın users/{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ğer BOT'dir. Kişiler için değer HUMAN.

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ın name (ör. users/123456789).
    • People API'de resourceName öğesinin people/{person_id} olduğu bir Person kaynağının adı için {person_id}. Örneğin, Chat API'deki users/123456789, People API'deki people/123456789 ile aynı kişiyi temsil eder.
    • Directory API'deki bir User kaynağı için id (ör. Chat API'deki users/123456789), Directory API'deki users/123456789 ile aynı kişiyi temsil eder.

  • 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 veya users/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: