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

Bu sayfada, Google Chat uygulamalarının Sohbet kullanıcıları.

Chat uygulaması, aşağıdakilerden herhangi birini yapabilmek için bir kullanıcı belirtmelidir:

Chat, kullanıcıları nasıl tespit eder?

Google Chat API, User kaynak Chat'i kullanan herkes için geçerli olur. Aşağıda iki önemli nokta var: User alan:

  • name, kaynağın users/{user} biçiminde biçimlendirilen kaynak adıdır. Burada {user} , benzersiz ve sabit bir tanımlayıcıyı temsil eder. users/app şunları yapabilir: olarak kullanılmalıdır Chat uygulamasının takma adı.
  • type, kullanıcı türüdür. Bu tür, Chat'e Kullanıcı bir Chat uygulaması veya kişidir. Örneğin, Chat uygulamaları için değer: BOT. Kullanıcılar için değeri HUMAN

Google Chat API'ye yapılan bir çağrıda kullanıcı belirtme

Bir kullanıcı belirtmek üzere {user} değeri için aşağıdaki değerleri kullanın:

  • Google Workspace kuruluşunuzdaki kullanıcılar için aşağıdakilerden birini kullanın: şu yaklaşımlardan yararlanabilirsiniz:

    • name User kaynak Chat API'de (ör. users/123456789) oturum açın.
    • Bir {person_id} adı için People API'de Person kaynak resourceName değeri people/{person_id} olduğunda; örneğin, Chat API'deki users/123456789 aynı kişiyi temsil ediyor People API'de people/123456789 olarak görünür.
    • Directory API'deki bir User kaynağı için id; örneğin, Chat API'deki users/123456789 aynı kişiyi temsil ediyor Directory API'de users/123456789 olarak görünür.

  • Harici bir Google Workspace kuruluşundaki kullanıcı veya kullanıcılar için Google Hesabı kullanıyorsanız bir e-posta takma adı kullanıyorsanız. Örneğin, users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com veya users/EMAIL_USERNAME@gmail.com.

Bir kullanıcıyı etkileşim etkinliğinden tanımlama

Kullanıcılar bir Chat uygulamasıyla her etkileşimde bulunduğunda Chat, etkileşim etkinliği etkinliğinde sunulan, hem de kullanıcıyla ilgili. Örneğin, Kullanıcı bir mesajda Chat uygulamasından bahsettiğinde, Chat uygulaması, etkileşim hakkında bilgi alır. mesajı gönderen kişi gibi. Sohbet uygulamaları Chat kaynakları hakkında bilgi alırken kullanıcılara referansta bulunmak için kullanılır.

Bir Chat uygulamasıyla etkileşimde bulunan kullanıcıyı tanımlamak için: name özelliğinin değerini User kaynak, Bu araçları Event.user.name.

Aşağıdaki JSON örneği, Chat uygulamasıyla etkileşim:

{
  ...,
  "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 kullanıcıyı gönderen Chat uygulamasına bir mesaj gönderir, name özelliğinin değerini Aşağıdakilerden birini kullanan User kaynak takip etmek için: