Bir yöneticinin yaptığı aramaya göre Google Workspace kuruluşundaki alanların listesini döndürür.
Yönetici ayrıcalıklarına sahip kullanıcı kimlik doğrulaması gerektirir. İstekte useAdminAccess
değerini true
olarak ayarlayın.
HTTP isteği
GET https://chat.googleapis.com/v1/spaces:search
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler | |
---|---|
use |
Görüşmeyi yapan kullanıcı, sohbet ve alan görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.
Bu yöntem şu anda yalnızca yönetici erişimini desteklediğinden bu alan için yalnızca |
page |
Döndürülecek maksimum boşluk sayısı. Hizmet, bu değerden daha az bir değer döndürebilir. Belirtilmezse en fazla 100 alan döndürülür. Maksimum değer 1.000'dür. 1000'den fazla bir değer kullanırsanız bu değer otomatik olarak 1000'e değiştirilir. |
page |
Önceki arama alanları çağrısından alınan bir jeton. 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. |
query |
Zorunlu. Arama sorgusu. Aşağıdaki parametreleri kullanarak arama yapabilirsiniz:
Farklı alanlarda yalnızca Aynı alanda Aşağıdaki örnek sorgular geçerlidir:
|
order |
İsteğe bağlı. Alan listesinin sıralaması. Sıralama için desteklenen özellikler şunlardır:
Geçerli sıralama işlemi değerleri şunlardır:
Desteklenen söz dizimi:
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Arama alanları isteğine karşılık gelen alanların listesini içeren yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"spaces": [
{
object ( |
Alanlar | |
---|---|
spaces[] |
İstenen alanların bir sayfası. |
next |
Sonraki sayfayı almak için kullanılabilecek bir jeton. Bu alan boşsa sonraki sayfa yoktur. |
total |
Tüm sayfalarda sorguyla eşleşen alanların toplam sayısı. Sonuç 10.000 boşluktan fazlaysa bu değer tahminidir. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/chat.admin.spaces
https://www.googleapis.com/auth/chat.admin.spaces.readonly
Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.