Method: spaces.list

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Arayanın üyesi olduğu ve arayan veya kimliği doğrulanmış kullanıcının görebileceği alanları listeler. Kimlik doğrulama gerektirir. Hizmet hesabı kimlik doğrulamasını tam olarak destekler.

HTTP isteği

GET https://chat.googleapis.com/v1/spaces

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

Sorgu parametreleri

Parametreler
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum alan sayısı. Hizmet bu değerden daha az değer döndürebilir.

Belirtilmemesi halinde en fazla 100 alan döndürülür.

Maksimum değer 1000'dir; 1000'in üzerindeki değerler 1000'e zorlanır.

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

pageToken

string

İsteğe bağlı. Önceki liste alanları çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu değeri sağlayın.

Sayfalara ayırma sırasında filtre değeri, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Farklı bir değer iletilmesi, beklenmedik sonuçlar doğurabilir.

filter

string

İsteğe bağlı. Sorgu filtresi.

Kullanıcı kimlik doğrulaması gerektirir.

API, spaceType etiketine göre filtrelemeyi destekler.

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

spaceType = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

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

Hizmet hesabı kimlik doğrulaması ile bu alan yoksayılır ve sorgu her zaman tüm alanları döndürür. Ancak Chat API, sorgu söz dizimini hizmet hesaplarıyla doğrulamaya devam eder. Bu nedenle, geçersiz sorgular yine reddedilir.

İstek metni

İstek metni boş olmalıdır.

Yanıt gövdesi

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

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

object (Space)

İstenen (veya ilk) sayfadaki alanların listesi.

nextPageToken

string

Sonraki sonuç sayfasını almak için pageToken olarak gönderilebilen bir jeton. Boşsa takip edilen sayfa yoktur.

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.bot

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