Google Chat etkinliklerine abone olma

Bu sayfada, bir Chat uygulamasının Google Workspace Events API'yi kullanarak abone olabileceği Chat etkinlikleri açıklanmaktadır. İhtiyacınız olan etkinlik türlerine karar verdikten sonra Chat'ten etkinlik almaya başlamak için bir abonelik oluşturun.

Etkinliklere abone olmanın yanı sıra Google Chat API'yi çağırarak etkinlikleri sorgulayabilirsiniz. Chat API'yi çağırarak etkinlikleri düzenli olarak alabilir veya kesinti nedeniyle bir abonelikten kaçırmış olabileceğiniz etkinlikleri yakalayabilirsiniz. Chat etkinliklerini almanın ve yanıtlamanın yolları hakkında bilgi edinmek için Chat belgelerindeki Chat'teki etkinliklerle çalışma başlıklı makaleyi inceleyin.

Desteklenen Chat etkinlikleri

Google Workspace abonelikleri, Chat'te aşağıdaki değişiklik türleriyle ilgili etkinlikleri almanıza olanak tanır:

• Alandaki yeni, güncellenmiş veya silinmiş mesajlar.
• Bir mesaja yeni eklenen veya kaldırılan tepkiler.
• Alandaki yeni, güncellenmiş veya kaldırılmış üyeler.
• Abone olduğunuz alanda yapılan değişiklikler (ör. alan adının veya açıklamasının güncellenmesi)
• Kullanıcının müsaitlik durumunda yapılan değişiklikler.
• Kullanıcının spaceReadState veya threadReadState değerinde yapılan değişiklikler.

Etkinlikler için izleyebileceğiniz kaynaklar

Etkinlikleri almak için izlenecek bir Chat kaynağı belirtirsiniz. Bu kaynak, aboneliğin hedef kaynağı olarak adlandırılır.

Google Workspace Events API, Chat için aşağıdaki hedef kaynakları destekler:

Abonelik oluşturma etkinlik türleri

Abonelik oluştururken almak istediğiniz etkinlik türlerini belirtmek için eventTypes[] alanını kullanın. Etkinlik türleri, CloudEvents spesifikasyonuna göre biçimlendirilir (ör. google.workspace.APPLICATION.RESOURCE.VERSION.ACTION).

Örneğin, kullanıcıların bir Chat alanına katılmasıyla ilgili etkinlikleri almak için hedef kaynak olarak alanı, etkinlik türü olarak da google.workspace.chat.membership.v1.created değerini belirtin. Belirli bir kullanıcının herhangi bir alana katılmasıyla ilgili etkinlikleri almak için hedef kaynak olarak kullanıcıyı, etkinlik türü olarak da google.workspace.chat.membership.v1.created değerini belirtin. Etkinliklerin işleyiş şekli hakkında daha fazla bilgi edinmek için Google Workspace etkinliklerinin yapısı başlıklı makaleyi inceleyin.

Aşağıdaki tabloda, alanlara ve kullanıcılara abonelikler için desteklenen etkinlik türleri gösterilmektedir. Bir etkinliği tetikleyen durumlarla ilgili istisnalar hakkında bilgi edinmek için Sınırlamalar bölümüne bakın.

Toplu etkinlik türleri (yalnızca çıkış)

Chat uygulamanız, abone olduğunuz etkinlik türlerini almanın yanı sıra toplu etkinlikler de alabilir. Toplu etkinlik, kısa bir süre içinde gerçekleşen aynı türden birçok etkinliği temsil eden bir etkinliktir. Toplu etkinlik yükü, değiştirilen tüm kaynakların listesini içerir.

Örneğin, bir kullanıcı bir alana aynı anda 20 kullanıcı eklerse Chat uygulamanız toplu etkinlik (google.workspace.chat.membership.v1.batchCreated) alabilir. Etkinlik yükü, kullanıcı alana üyeleri eklediğinde oluşturulan tüm yeni Membership kaynaklarının listesini içerir.

Abone olduğunuz her etkinlik türü için bir toplu etkinlik alırsınız. Bu nedenle, abonelik oluştururken toplu etkinlikleri belirtmeniz gerekmez. Örneğin, yeni tepkilere (google.workspace.chat.reaction.v1.created) abone olursanız Chat uygulamanız, toplu tepki etkinliklerini (google.workspace.chat.reaction.v1.batchCreated) alacak şekilde otomatik olarak yapılandırılır.

Aşağıdaki tabloda, bir abonelik için olası toplu etkinlikler gösterilmektedir:

Etkinlik verileri

Bu bölümde, Chat'teki etkinliklerle ilgili etkinlik verileri ve örnek yükler açıklanmaktadır.

Google Workspace aboneliğiniz Chat'ten bir etkinlik aldığında data alanı, etkinliğin yükünü içerir. Bu yük, değişen Google Workspace kaynağı hakkında bilgi içerir. Örneğin, bir alandaki üyelik etkinliklerine abone olduysanız bu etkinliklerin yükü, değişen spaces.membership kaynağı hakkında bilgi içerir.

Etkinlik yükündeki kaynak verileri

Abonelik oluştururken yükün kaynakla ilgili ayrıntıları mı yoksa yalnızca kaynağın adını mı içermesini istediğinizi belirtebilirsiniz. Örneğin, bir Chat alanındaki üyelerle ilgili etkinlikleri almak istiyorsanız etkinlik yükünde bir üyelik kaynağının hangi alanlarını almak istediğinizi belirtin.

Aşağıdaki tabloda, spaces/AAAABBBBBB Chat alanına abonelik için JSON yükü örnekleri verilmiştir. Aboneliğin aldığı her etkinlik için yük, etkinliğin data alanında görünür:

{
    "message":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID",
        "sender":
        {
            "name": "users/USER_ID",
            "type": "HUMAN"
        },
        "createTime": "2023-09-07T21:37:36.260127Z",
        "text": "Hello world",
        "thread":
        {
            "name": "spaces/SPACE_ID/threads/THREAD_ID"
        },
        "space":
        {
            "name": "spaces/SPACE_ID"
        },
        "argumentText": "Hello world"
    }
}
      

{
    "message":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID"
    }
}
      

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

{
    "membership":
    {
        "name": "spaces/SPACE_ID/members/MEMBER_ID"
    }
}
      

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

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

{
    "memberships": [
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID",
            "state": "JOINED",
            "member":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "createTime": "1970-01-01T00:00:00Z",
            "role": "ROLE_MEMBER"
          }
        },
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID",
            "state": "JOINED",
            "member":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "createTime": "1970-01-01T00:00:00Z",
            "role": "ROLE_MEMBER"
          }
        }
    ]
}
      

{
    "memberships": [
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID"
          }
        },
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID"
          }
        }
    ]
}
      

{
    "reaction":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
        "user":
        {
            "name": "users/USER_ID",
            "type": "HUMAN"
        },
        "emoji":
        {
            "unicode": "😊"
        }
    }
}
      

{
    "reaction":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID"
    }
}
      

{
    "reactions": [
        {
          "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
            "user":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "emoji":
            {
                "unicode": "😊"
            }
          }
        },
        {
          "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
            "user":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "emoji":
            {
                "unicode": "😸"
            }
          }
        }
    ]
}
      

{
    "reactions": [
      {
        "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID"
        },
        "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
        }
      }
    ]
}
      

{
  "spaceReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/spaceReadState",
    "lastReadTime": "2026-04-14T14:03:46.431760Z"
  }
}
      

{
  "spaceReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/spaceReadState"
  }
}
      

{
  "threadReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/threads/THREAD_ID/threadReadState",
    "lastReadTime": "2026-04-14T14:03:46.431760Z"
  }
}
      

{
  "threadReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/threads/THREAD_ID/threadReadState"
  }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
        "state": "ACTIVE"
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
        "state": "IDLE",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
        "state": "AWAY",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
        "state": "DO_NOT_DISTURB",
        "doNotDisturbMetadata": {
          "expirationTime": "2026-03-24T18:36:31.337Z"
        }
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
        "state": "ACTIVE",
        "customStatus": {
          "text": "Be right back",
          "emoji": {
            "unicode": "👟"
          },
          "expireTime": "2026-03-24T18:38:05.583655Z"
        }
    }
}
      

{
    "availability":
    {
        "name": "users/USER_ID/availability",
    }
}
      

Genel sınırlamalar

• Üyelik etkinliklerini almak için kullanıcının veya Chat uygulamasının alanın doğrudan üyesi olması gerekir. Bir Google Grubu aracılığıyla bir alana dolaylı olarak eklenmiş, güncellenmiş veya kaldırılmışsa abonelik bu üyelik etkinliklerini almaz. Google Grubu üyeliklerinin işleyiş şeklini anlamak için Alana Google Grubu ekleme başlıklı makaleyi inceleyin.

Kullanıcı abonelikleri

• Kullanıcı aboneliklerinde, doğrudan mesajlardaki veya adsız grup sohbetlerindeki (google.workspace.chat.membership.v1.created) yeni üyelerle ilgili etkinlikler yalnızca ilk mesaj yayınlandıktan sonra tetiklenir.

Müşteri abonelikleri

Müşteri abonelikleri için aşağıdaki sınırlamalar geçerlidir:

• Google Workspace kuruluşunun en az bir Enterprise SKU lisansı olmalıdır.
• Bir Chat uygulaması, belirli bir Google Workspace kuruluşu için yalnızca bir müşteri aboneliği oluşturabilir. Bir Google Workspace kuruluşunun toplamda en fazla beş müşteri aboneliği (farklı Chat uygulamaları tarafından oluşturulmuş) olabilir.

Müşteri abonelikleri için etkinlik yayınlama aşağıdaki genel kurallara uyar:

• Alan etkinlikleri: Yalnızca etkinlik, Google Workspace kuruluşunuz tarafından yönetilen bir alanda gerçekleşirse yayınlanır.
• Kullanıcı etkinlikleri: Yalnızca Google Workspace kuruluşunuza ait bir kullanıcı için etkinlik gerçekleşirse yayınlanır.

Bu kuralların tek istisnası üyelik etkinlikleridir. Aboneliğiniz, hem kuruluşunuz tarafından yönetilen alanlardan hem de harici kuruluşlar tarafından yönetilen alanlardan üyelik etkinlikleri alabilir. Ancak bu etkinliklerin nasıl yayınlanacağı, alanı hangi kuruluşun yönettiğine bağlıdır:

Google Workspace kuruluşunuz tarafından yönetilen alanlar

Google Workspace kuruluşu tarafından yönetilen bir alanda üyelik değişikliği olursa bu değişiklik alan etkinliği olarak yayınlanır.

Alan etkinliğinin kaynak adı aşağıdaki biçimi kullanır:

spaces/{spaceId}/spaceEvents/{spaceEventId}

Harici kuruluşlar tarafından yönetilen alanlar

Google Workspace kuruluşunuz tarafından yönetilen bir kullanıcının üyeliği, harici bir kuruluş tarafından yönetilen bir alanda (ör. harici bir adlandırılmış alan veya harici bir kullanıcı tarafından oluşturulan doğrudan mesaj) değişirse aboneliğiniz bu etkinliği kullanıcı etkinliği olarak alır.

Kullanıcı etkinliğinin kaynak adı aşağıdaki biçimi kullanır:

users/{userId}/userEvents/{userEventId}

İlgili konular

• Google Workspace etkinliklerinin yapısı
• OAuth kapsamlarını seçme
• Chat etkinliklerini almak için abonelik oluşturun.