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.

Chat uygulamalarının aşağıdakilerden herhangi birini yapması için bir kullanıcı belirtmesi gerekir:

Chat, kullanıcıları nasıl tanımlar?

Google Chat API, Chat 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} olarak biçimlendirilmiş kaynak adıdır. Burada {user}, benzersiz ve sabit bir tanımlayıcıyı temsil eder. users/app, arayan Chat uygulaması için bir takma ad olarak kullanılabilir.
  • type, kullanıcı türüdür. Bu tür, kullanıcının Chat uygulaması mı yoksa kişi mi olduğunu Chat'e bildirir. Sohbet uygulamaları için değer BOT'tür. Kişiler için değer HUMAN olur.

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

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

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

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

  • Kuruluş dışı bir Google Workspace kuruluşundaki veya Google Hesabı kullanan bir kullanıcı için e-posta takma adı kullanın (ör. users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com veya users/EMAIL_USERNAME@gmail.com).

Etkileşim etkinliğinden kullanıcı tanımlama

Kullanıcı bir Chat uygulamasıyla her etkileşimde bulunduğunda Chat, etkileşim ve kullanıcı hakkında bilgi içeren bir etkileşim etkinliği gönderir. Örneğin, bir kullanıcı mesajında Chat uygulamasından bahsettiğinde Chat uygulaması, mesajın içeriği ve gönderen dahil olmak üzere etkileşim hakkında bilgi alır. Chat uygulamaları, Chat kaynakları hakkında bilgi alırken kullanıcılara referans verir.

Bir Chat uygulamasıyla etkileşime geçen kullanıcıyı tanımlamak için User kaynağındaki name mülkünün değerini alın. Bu değeri Event.user.name kaynağından alabilirsiniz.

Aşağıdaki JSON örneğinde, 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ğındaki name mülkünün değerini alın: