Method: spaces.spaceEvents.list

Google Chat alanındaki etkinlikleri listeler. Her etkinlik için yük, Chat kaynağının en son sürümünü içerir. Örneğin, yeni alan üyeleriyle ilgili etkinlikleri listelerseniz sunucu, en son üyelik ayrıntılarını içeren Membership kaynaklarını döndürür. İstenen dönemde yeni üyeler kaldırıldıysa etkinlik yükü boş bir Membership kaynağı içerir.

İstenen verilerin okunması için uygun bir yetkilendirme kapsamıyla aşağıdaki kimlik doğrulama türlerini destekler:

  • Geliştirici Önizlemesi'nde aşağıdaki yetkilendirme kapsamlarından biriyle yönetici onayı içeren uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.app.spaces
    • https://www.googleapis.com/auth/chat.app.messages.readonly
    • https://www.googleapis.com/auth/chat.app.memberships

  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.messages.reactions.readonly
    • https://www.googleapis.com/auth/chat.messages.reactions
    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships

Etkinlikleri listelemek için kimliği doğrulanmış arayan, alanın üyesi olmalıdır.

Örnek için Google Chat alanındaki etkinlikleri listeleme başlıklı makaleyi inceleyin.

HTTP isteği

GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Etkinliklerin gerçekleştiği Google Chat alanının kaynak adı.

Biçim: spaces/{space}.

Sorgu parametreleri

Parametreler
pageSize

integer

İsteğe bağlı. Döndürülen maksimum alan etkinliği sayısı. Hizmet, bu değerden daha az sonuç döndürebilir.

Negatif değerler INVALID_ARGUMENT hatası döndürür.
pageToken

string

İsteğe bağlı. Önceki bir list space events çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalama yapılırken, liste alanı etkinlikleri için sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Diğer parametrelere farklı değerler iletmek beklenmedik sonuçlara yol açabilir.
filter

string

Zorunlu. Sorgu filtresi.

has : operatörünü kullanarak en az bir etkinlik türü (eventType) belirtmeniz gerekir. Birden fazla etkinlik türüne göre filtrelemek için OR operatörünü kullanın. Filtrenizde toplu etkinlik türlerini hariç tutun. İstek, ilgili tüm toplu etkinlikleri otomatik olarak döndürür. Örneğin, yeni tepkilere (google.workspace.chat.reaction.v1.created) göre filtreleme yaparsanız sunucu, toplu yeni tepki etkinliklerini (google.workspace.chat.reaction.v1.batchCreated) de döndürür. Desteklenen etkinlik türlerinin listesi için SpaceEvents referans belgelerine bakın.

İsteğe bağlı olarak, başlangıç zamanına (startTime) ve bitiş zamanına (endTime) göre de filtre uygulayabilirsiniz:

  • startTime: Alan etkinliklerini listelemeye başlamak için özel zaman damgası. 28 gün öncesine kadar olan etkinlikleri listeleyebilirsiniz. Belirtilmediyse son 28 gündeki alan etkinliklerini listeler.
  • endTime: Alan etkinliklerinin listelendiği son zaman damgası. Belirtilmediyse istek zamanına kadar olan etkinlikleri listeler.

Başlangıç veya bitiş zamanı belirtmek için eşittir = operatörünü kullanın ve RFC-3339 biçiminde ayarlayın. Hem startTime hem de endTime ile filtrelemek için AND operatörünü kullanın.

Örneğin, aşağıdaki sorgular geçerlidir:

startTime="2023-08-23T19:20:33+00:00" AND
endTime="2023-08-23T19:21:54+00:00"

startTime="2023-08-23T19:20:33+00:00" AND
(eventTypes:"google.workspace.chat.space.v1.updated" OR
eventTypes:"google.workspace.chat.message.v1.created")

Şu sorgular geçersiz:

startTime="2023-08-23T19:20:33+00:00" OR
endTime="2023-08-23T19:21:54+00:00"

eventTypes:"google.workspace.chat.space.v1.updated" AND
eventTypes:"google.workspace.chat.message.v1.created"

Geçersiz sorgular, sunucu tarafından INVALID_ARGUMENT hatasıyla reddedilir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Listeleme alanı etkinlikleri için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "spaceEvents": [
    {
      object (SpaceEvent)
    }
  ],
  "nextPageToken": string
}
Alanlar
spaceEvents[]

object (SpaceEvent)

Sonuçlar kronolojik sırayla (en eski etkinlik önce) döndürülür. Not: permissionSettings alanı, liste istekleri için Space nesnesinde döndürülmez.
nextPageToken

string

Daha fazla etkinlik getirmek için kullanılan devamlılık jetonu. Bu alan atlanırsa sonraki sayfa olmaz.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.