- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Deneyin.
Engellenen üyeler ve alanlardan gelen mesajlar da dahil olmak üzere, arayanın üyesi olduğu bir alandaki mesajları listeler. Mesaj içermeyen bir alandan gelen mesajları listelerseniz yanıt boş bir nesne olur. REST/HTTP arayüzü kullanılırken yanıt boş bir JSON nesnesi ({}
) içerir. Örnek için Mesajları listeleme bölümüne göz atın. Kullanıcı kimlik doğrulaması gerekir.
HTTP isteği
GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
parent |
Zorunlu. Mesajlarının listeleneceği alanın kaynak adı. Biçim: |
Sorgu parametreleri
Parametreler | |
---|---|
pageSize |
Döndürülen maksimum ileti sayısı. Hizmet, bu değerden daha az ileti döndürebilir. Belirtilmezse en fazla 25 kod döndürülür. Maksimum değer 1.000'dir. 1000'den fazla bir değer kullanırsanız bu değer otomatik olarak 1000'e değiştirilir. Negatif değerler |
pageToken |
Önceki bir sorgudan devam ettiriliyorsa isteğe bağlıdır. Önceki bir liste mesajları çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu parametreyi sağlayın. Sayfalara ayırırken, 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 |
Sorgu filtresi. İletileri tarihe ( İletileri oluşturuldukları tarihe göre filtrelemek için İleti dizisine göre filtrelemek için Hem ileti dizisine hem de tarihe göre filtrelemek için sorgunuzda Örneğin, aşağıdaki sorgular geçerlidir:
Geçersiz sorgular |
orderBy |
Önceki bir sorgudan devam ettiriliyorsa isteğe bağlıdır. Mesaj listesinin sıralanma şekli. Sıralama işlemine göre sıralanacak bir değer belirtin. Geçerli sipariş işlemi değerleri şunlardır:
Varsayılan sıralama |
showDeleted |
Silinen iletilerin eklenip eklenmeyeceğini belirtir. Silinen iletiler arasında, silinen zamanı ve silinme zamanıyla ilgili meta verileri içerir ancak ileti içeriği mevcut değildir. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Mesajları listelemeyle ilgili yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"messages": [
{
object ( |
Alanlar | |
---|---|
messages[] |
Mesaj listesi. |
nextPageToken |
Sonuçların sonraki sayfasını almak için |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.