Method: spaces.findGroupChats

spaceType == GROUP_CHAT ile başlayan, üyeliklerinde tam olarak arayan kullanıcıyı ve FindGroupChatsRequest.memberships içinde belirtilen kullanıcıları içeren tüm alanları döndürür.

Arayan kullanıcı bazı kullanıcıları engellerse veya bazı kullanıcılar tarafından engellenirse ve belirtilen kullanıcı grubunun tamamının bulunduğu alan bulunamazsa bu yöntem, engellenen veya engelleyen kullanıcıları içermeyen alanları döndürür.

Belirtilen kullanıcı grubu yalnızca insan (uygulama dışı) üyeliklerini içermelidir. İnsan olmayan kullanıcılar içeren bir istek hiçbir alan döndürmez.

Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.memberships

HTTP isteği

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

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

Sorgu parametreleri

Parametreler
user[]

string

Arayan kullanıcıyla grup sohbetindeki tüm gerçek kullanıcıların kaynak adları. İsteğe Chat uygulamaları dahil edilemez.

Biçim: users/{user}. Burada {user}, People API'deki kişi için id veya Directory API'deki kullanıcı için id olur. Örneğin, arayan kullanıcı ve iki başka kullanıcıyla yapılan tüm grup sohbetlerini bulmak için (People API profil kimlikleri 123456789 ve 987654321) users/123456789 ve users/987654321 kullanabilirsiniz. E-postayı {user} için takma ad olarak da kullanabilirsiniz. Örneğin, users/example@gmail.com. Burada example@gmail.com, Google Chat kullanıcısının e-posta adresidir.

Arayan kullanıcı bir Google Workspace kullanıcısıysa istenen tüm kullanıcılar, arayan kullanıcıyla aynı Google Workspace kuruluşunun üyesi olmalıdır.

pageSize

integer

İsteğe bağlıdır. Döndürülecek maksimum boşluk sayısı. Hizmet, bu değerden daha az sonuç döndürebilir.

Belirtilmezse 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ıdır. Grup sohbetlerini bulmak için önceki bir çağrıdan alınan sayfa jetonu. Sonraki sayfayı almak için bu parametreyi sağlayın.

Sayfalama yapılırken sağlanan diğer tüm parametreler, jetonu sağlayan çağrıyla eşleşmelidir. Farklı değerler iletmek beklenmedik sonuçlara yol açabilir.

spaceView

enum (SpaceView)

İstenen alan görünümü türü. Ayarlanmamışsa varsayılan olarak SPACE_VIEW_RESOURCE_NAME_ONLY olur. SPACE_VIEW_EXPANDED belirten istekler, alan verilerinin okunmasına izin veren kapsamları (ör. https://www.googleapis.com/auth/chat.spaces veya https://www.googleapis.com/auth/chat.spaces.readonly) içermelidir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Arayan kullanıcı ve istenen kullanıcıların bulunduğu grup sohbeti alanlarını içeren bir 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 bir sonraki sayfasını almak için pageToken olarak gönderebileceğiniz bir jeton. Boşsa sonraki sayfalar yoktur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

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

SpaceView

Alan kaynağında hangi alanların doldurulması gerektiğini belirten bir görünüm. Gelecekteki sürümlerle uyumluluğu sağlamak için kodunuzun ek değerleri hesaba katmasını öneririz.

Sıralamalar
SPACE_VIEW_UNSPECIFIED Varsayılan / ayarlanmamış değer.
SPACE_VIEW_RESOURCE_NAME_ONLY Yalnızca alan kaynak adını doldurur.
SPACE_VIEW_EXPANDED Alan kaynağı alanlarını doldurur. Not: permissionSettings alanı doldurulmaz. SPACE_VIEW_EXPANDED'ı belirten istekler, alan verilerinin okunmasına izin veren kapsamları (ör. https://www.googleapis.com/auth/chat.spaces veya https://www.googleapis.com/auth/chat.spaces.readonly) içermelidir.