Method: spaces.list

Arayanın üyesi olduğu alanları listeler. İlk mesaj gönderilene kadar grup sohbetleri ve DM'ler listelenmez. Örnek için Alanları listeleme bölümünü inceleyin.

Kimlik doğrulama gerektirir. Uygulama kimlik doğrulaması ve kullanıcı kimlik doğrulamasını destekler.

Arayan veya kimliği doğrulanmış kullanıcı tarafından görülebilen alanları listeler. İlk mesaj gönderilene kadar grup sohbetleri ve DM'ler listelenmez.

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 boşluk sayısı. Hizmet bu değerden daha az sonuç döndürebilir.

Belirtilmemesi durumunda en fazla 100 boşluk döndürülür.

Maksimum değer 1.000'dir. 1.000'den büyük bir değer kullanırsanız bu değer otomatik olarak 1.000 olarak değiştirilir.

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

pageToken

string

İsteğe bağlı. Önceki bir Alanlar listesi çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu parametreyi sağlayın.

Sayfalara ayırma işlemi sırasında filtre değeri, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Farklı bir değer iletmek beklenmeyen sonuçlara yol açabilir.

filter

string

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

Alanları, alan türüne göre (spaceType) filtreleyebilirsiniz.

Alan türüne göre filtrelemek için SPACE veya GROUP_CHAT gibi geçerli bir enum değeri belirtmeniz gerekir (spaceType, SPACE_TYPE_UNSPECIFIED olamaz). Birden çok alan türünü sorgulamak için OR operatörünü kullanın.

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

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

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

İstek içeriği

İ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

Bir sonraki sonuç sayfasını almak için pageToken olarak bir jeton gönderebilirsiniz. Boş bırakılırsa sonraki 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.