Bir Google Chat alanındaki etkinlikleri listeler. Her etkinlik için payload, 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ı döndürür. İstenen dönemde yeni üyeler kaldırıldıysa etkinlik yükü boş bir Membership kaynağı içerir.
Kullanıcı kimlik doğrulaması gerektirir. Etkinlikleri listelemek için kimliği doğrulanmış kullanıcının alanın üyesi olması gerekir.
İsteğe bağlı. Önceki bir liste alanı etkinlikleri çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.
Sayfalandırma yaparken, alan etkinliklerini listelemek 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 göndermek beklenmedik sonuçlara neden olabilir.
filter
string
Zorunlu. Sorgu filtresi.
": 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 çıkarın. İ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, yeni tepkiler toplu etkinliğini (google.workspace.chat.reaction.v1.batchCreated) de döndürür. Desteklenen etkinlik türlerinin listesi için SpaceEvents referans dokümanlarına bakın.
İsteğe bağlı olarak başlangıç zamanına (startTime) ve bitiş zamanına (endTime) göre de filtreleme yapabilirsiniz:
startTime: Alan etkinliklerini listelemenin başlayacağı özel zaman damgası. 28 güne kadar önce gerçekleşen etkinlikleri listeleyebilirsiniz. Belirtilmemişse son 28 güne ait alan etkinliklerini listeler.
endTime: Alan etkinliklerinin listelendiği zaman damgası. Belirtilmemişse istek zamanına kadar olan etkinlikleri listeler.
Başlangıç veya bitiş saatini belirtmek için eşittir = operatörünü kullanın ve RFC-3339 biçimini uygulayın. Hem startTime hem de endTime'ye göre 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")
Aşağıdaki 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
Alan etkinliklerini listelemeyle ilgili yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2024-11-08 UTC."],[[["Lists events from a specified Google Chat space, including new members, messages, and reactions, with the payload containing the most recent version of the resource."],["Requires user authentication and membership in the space to list events, returning data chronologically with optional pagination."],["Allows filtering by event types, start time, and end time to refine the results of the listed events."],["The response includes an array of space events and a token for retrieving subsequent pages if available."],["Needs specific authorization scopes for accessing and retrieving the chat space data."]]],["This documentation outlines how to list events from a Google Chat space using the `GET` method. Key actions include: specifying the space via the `parent` path parameter, filtering events by type and time using the `filter` query parameter, and setting the number of events returned with `pageSize`. `pageToken` is used for pagination. Authentication requires user membership in the space and specific OAuth scopes. The response body includes a list of `spaceEvents` and a `nextPageToken` for further results.\n"]]
