- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Deneyin.
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, alanın yeni üyeleriyle ilgili etkinlikleri listelerseniz sunucu, en güncel üyelik ayrıntılarını içeren Membership
kaynaklarını döndürür. İstenen dönemde yeni üyeler kaldırılırsa etkinlik yükü boş bir Membership
kaynağı içerir.
Kullanıcı kimlik doğrulaması gerekir. Etkinlikleri listelemek için, kimliği doğrulanmış kullanıcının alanın bir üyesi olması gerekir.
Örnek için Bir 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 |
Zorunlu. Etkinliklerin gerçekleştiği Google Chat alanının kaynak adı. Biçim: |
Sorgu parametreleri
Parametreler | |
---|---|
pageSize |
İsteğe bağlı. Döndürülen maksimum alan etkinliği sayısı. Hizmet bu değerden daha az değer döndürebilir. Negatif değerler |
pageToken |
Önceki bir liste alanı etkinlikleri çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın. Sayfalara ayırma işlemi sırasında 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 aktarmak beklenmedik sonuçlara yol açabilir. |
filter |
Zorunlu. Sorgu filtresi. Sahip Dilerseniz başlangıç zamanı (
Bir başlangıç veya bitiş zamanı belirtmek için eşittir Örneğin, aşağıdaki sorgular geçerlidir:
Şu sorgular geçersizdir:
Geçersiz sorgular |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Alan etkinliklerinin listelenmesi 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 ( |
Alanlar | |
---|---|
spaceEvents[] |
Sonuçlar kronolojik sırada (önce en eski etkinlik) döndürülür. |
nextPageToken |
Daha fazla etkinlik getirmek için kullanılan devam jetonu. Bu alan atlanırsa sonraki sayfa olmaz. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
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ılavuzunu inceleyin.