Method: spaces.search

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
useAdminAccess

boolean

true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.spaces.readonly veya chat.admin.spaces OAuth 2.0 kapsamı gerekir.

Bu yöntem şu anda yalnızca yönetici erişimini desteklediğinden bu alan için yalnızca true kabul edilir.
pageSize

integer

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'dir. 1000'den fazla bir değer kullanırsanız bu değer otomatik olarak 1000'e değiştirilir.
pageToken

string

Önceki arama alanları görüşmesinden 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 göndermek beklenmedik sonuçlara neden olabilir.
query

string

Zorunlu. Arama sorgusu.

Aşağıdaki parametreleri kullanarak arama yapabilirsiniz:

  • createTime
  • customer
  • displayName
  • externalUserAllowed
  • lastActiveTime
  • spaceHistoryState
  • spaceType

createTime ve lastActiveTime, RFC-3339 biçiminde bir zaman damgası kabul eder. Desteklenen karşılaştırma operatörleri şunlardır: =, <, >, <=, >=.

customer zorunludur ve alanların hangi müşteriden getirileceğini belirtmek için kullanılır. Yalnızca customers/my_customer değeri desteklenir.

displayName yalnızca HAS (:) operatörünü kabul eder. Eşlenecek metin önce jetonlara ayrılır ve her jeton, alanın displayName kısmındaki herhangi bir alt dize olarak büyük/küçük harf duyarlılığı olmadan ve bağımsız olarak önek eşlemesi yapılır. Örneğin, Fun Eve, Fun event veya The evening was fun ile eşleşir ancak notFun event veya even ile eşleşmez.

externalUserAllowed, true veya false kabul edilir.

spaceHistoryState yalnızca space kaynağının historyState alanındaki değerleri kabul eder.

spaceType gereklidir ve yalnızca SPACE değeri geçerlidir.

Farklı alanlarda yalnızca AND operatörleri desteklenir. Geçerli bir örnek spaceType = "SPACE" AND displayName:"Hello", geçersiz bir örnek ise spaceType = "SPACE" OR displayName:"Hello" şeklindedir.

spaceType, aynı alanda AND veya OR operatörlerini desteklemez. displayName, "spaceHistoryState" ve "externalUserAllowed" yalnızca OR operatörleri desteklenir. lastActiveTime ve createTime hem AND hem de OR operatörlerini destekler. AND yalnızca lastActiveTime < "2022-01-01T00:00:00+00:00" AND lastActiveTime > "2023-01-01T00:00:00+00:00" gibi bir aralığı temsil etmek için kullanılabilir.

Aşağıdaki örnek sorgular geçerlidir:

customer = "customers/my_customer" AND spaceType = "SPACE"

customer = "customers/my_customer" AND spaceType = "SPACE" AND
displayName:"Hello World"

customer = "customers/my_customer" AND spaceType = "SPACE" AND
(lastActiveTime < "2020-01-01T00:00:00+00:00" OR lastActiveTime >
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND spaceType = "SPACE" AND
(displayName:"Hello World" OR displayName:"Fun event") AND
(lastActiveTime > "2020-01-01T00:00:00+00:00" AND lastActiveTime <
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND spaceType = "SPACE" AND
(createTime > "2019-01-01T00:00:00+00:00" AND createTime <
"2020-01-01T00:00:00+00:00") AND (externalUserAllowed = "true") AND
(spaceHistoryState = "HISTORY_ON" OR spaceHistoryState = "HISTORY_OFF")
orderBy

string

İsteğe bağlı. Alan listesinin sıralanma şekli.

Sıralama ölçütü olarak desteklenen özellikler şunlardır:

  • membershipCount.joined_direct_human_user_count: Doğrudan bir alana katılan gerçek kullanıcıların sayısını belirtir.
  • lastActiveTime: Bu alandaki herhangi bir konuya en son uygun öğenin ne zaman eklendiğini gösterir.
  • createTime: Alanın oluşturulma zamanını gösterir.

Geçerli sıralama işlemi değerleri şunlardır:

  • Artan için ASC. Varsayılan değer.

  • Azalan için DESC.

Desteklenen söz dizimi:

  • membershipCount.joined_direct_human_user_count DESC
  • membershipCount.joined_direct_human_user_count ASC
  • lastActiveTime DESC
  • lastActiveTime ASC
  • createTime DESC
  • createTime ASC

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Alan arama isteğine karşılık gelen alanların bir 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 (Space)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Alanlar
spaces[]

object (Space)

İstenen alanların bir sayfası.
nextPageToken

string

Sonraki sayfayı almak için kullanılabilecek bir jeton. Bu alan boşsa sonraki sayfa yoktur.
totalSize

integer

Tüm sayfalarda sorguyla eşleşen boşlukları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.