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 gerekir. Uygulama kimlik doğrulamasını ve kullanıcı kimlik doğrulamasını destekler.

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

Google Workspace kuruluşuna göre tüm adlandırılmış alanları listelemek için Workspace yönetici ayrıcalıklarını kullanarak spaces.search() yöntemini kullanın.

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 değer döndürebilir.

Belirtilmezse en fazla 100 alan 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 INVALID_ARGUMENT hatası döndürür.

pageToken

string

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

Sayfalara ayırırken filtre değeri, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Farklı bir değer iletmek, beklenmedik sonuçlara yol açabilir.

filter

string

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

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

Alan türüne göre filtrelemek için SPACE veya GROUP_CHAT gibi geçerli bir sıralama 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

Alan listeleme isteğinin yanıtı.

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

Sonuçların sonraki sayfasını almak için pageToken olarak bir jeton gönderebilirsiniz. Boşsa sonrasında başka 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ılavuzunu inceleyin.