Google Chat etkinliklerine abone olma

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 sürede ekleyebilirsiniz.
  • 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

//chat.googleapis.com/spaces/SPACE

burada SPACE, Chat API space kaynağının kaynak adı. Kimliği alanın URL'sinden veya spaces.list() yöntemini çağırın.

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

//chat.googleapis.com/spaces/-

Abonelik yalnızca kullanıcının şuralardaki etkinlikleri alır: Google Workspace veya Google Hesabı üzerinden üyelere.
Kullanıcı

//cloudidentity.googleapis.com/users/USER

burada USER, Chat API user kaynağının kaynak adı. Ayrıntılar için bkz. Tanımlayın ve belirtin Google Chat kullanıcıları.

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 adını tıklayın. 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.

google.workspace.chat.message.v1.created

space.message

Bir mesaj güncellendi.

google.workspace.chat.message.v1.updated

space.message

Bir mesaj silindi.

google.workspace.chat.message.v1.deleted

space.message

Bir tepki oluşturulur.

google.workspace.chat.reaction.v1.created

space.message.reaction

Tepki silindiğinde

google.workspace.chat.reaction.v1.deleted

space.message.reaction

Alana bir üye eklenir.

google.workspace.chat.membership.v1.created

space.membership

Alandaki bir üye güncellendi.

google.workspace.chat.membership.v1.updated

space.membership

Alandan bir üye kaldırılır.

google.workspace.chat.membership.v1.deleted

space.membership

Alan güncellendi.

google.workspace.chat.space.v1.updated

space

Alan silindi.

google.workspace.chat.space.v1.deleted

space

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.

google.workspace.chat.membership.v1.created

space.membership

Kullanıcının bir alan üyeliği güncellenir.

google.workspace.chat.membership.v1.updated

space.membership

Kullanıcı bir alanın doğrudan üyesi olarak kaldırılır.

google.workspace.chat.membership.v1.deleted

space.membership

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.

google.workspace.chat.message.v1.batchCreated

Birden fazla mesaj güncellendi.

google.workspace.chat.message.v1.batchUpdated

Birden fazla mesaj silinir.

google.workspace.chat.message.v1.batchDeleted

Birden fazla tepki oluşturulur.

google.workspace.chat.reaction.v1.batchCreated

Birden fazla tepki silinir.

google.workspace.chat.reaction.v1.batchDeleted

Abone olunan alana birden çok üye veya abone olan kullanıcı birden fazla alana eklendi.

google.workspace.chat.membership.v1.batchCreated

Abone olunan alanda veya abone olan kullanıcı için birden fazla üyelik güncellenir.

google.workspace.chat.membership.v1.batchUpdated

Abone olunan alandan birden fazla üye veya abone olan kullanıcı birden fazla alandan çıkarıldı.

google.workspace.chat.membership.v1.batchDeleted

Alanda birden fazla güncelleme var.

google.workspace.chat.space.v1.batchUpdated

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.

google.workspace.chat.message.v1.created

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.

google.workspace.chat.membership.v1.updated

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.