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:

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.

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:

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:

{
    "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"
    }
}
      

{
    "message":
    {
        "name": "spaces/AAAABBBBBB/messages/CCCCCCCCC.DDDDDDDDD"
    }
}
      

{
    "membership":
    {
        "name": "spaces/AAAABBBBBB/members/1234567890987654321",
        "state": "JOINED",
        "member":
        {
            "name": "users/1234567890987654321",
            "type": "HUMAN"
        },
        "createTime": "1970-01-01T00:00:00Z",
        "role": "ROLE_MANAGER"
    }
}
      

{
    "membership":
    {
        "name": "spaces/AAAABBBBBB/members/1234567890987654321"
    }
}
      

{
    "space":
    {
        "name": "spaces/AAAABBBBBB",
        "displayName": "Cymbal Sales",
        "spaceThreadingState": "THREADED_MESSAGES",
        "spaceType": "SPACE",
        "spaceDetails":
        {
            "description": "Sales team for Cymbal Labs."
        },
        "spaceHistoryState": "HISTORY_ON"
    }
}
      

{
    "space":
    {
        "name": "spaces/AAAABBBBBB"
    }
}
      

{
    "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"
          }
        }
    ]
}
      

{
    "memberships": [
        {
          "membership": {
            "name": "spaces/AAAABBBBBB/members/1234567890987654321"
          }
        },
        {
          "membership": {
            "name": "spaces/AAAABBBBBB/members/98765432123456789019"
          }
        }
    ]
}
      

{
    "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/1111111111111111.222222222222222"
    }
}
      

{
    "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": "😸"
            }
          }
        }
    ]
}
      

{
    "reactions": [
      {
        "reaction": {
            "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222"
        },
        "reaction": {
            "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/3333333333333333.444444444444444",
        }
      }
    ]
}
      

• 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.

İlgili konular

• Google Workspace etkinliklerinin yapısı
• OAuth kapsamlarını seçin
• Şuna abonelik oluşturun: Chat etkinliklerini alma