Method: spaces.findGroupChats

Renvoie tous les espaces avec spaceType == GROUP_CHAT, dont les membres humains contiennent exactement l'utilisateur appelant et les utilisateurs spécifiés dans FindGroupChatsRequest.users. Seuls les membres qui ont rejoint la conversation sont acceptés. Pour obtenir un exemple, consultez la section Rechercher des discussions de groupe.

Si l'utilisateur appelant bloque certains utilisateurs ou est bloqué par eux, et qu'aucun espace ne contient l'ensemble spécifié d'utilisateurs, cette méthode renvoie les espaces qui n'incluent pas les utilisateurs bloqués ou bloquants.

L'ensemble spécifié d'utilisateurs ne doit contenir que des membres humains (non-application). Une requête contenant des utilisateurs non humains ne renvoie aucun espace.

Nécessite l'authentification de l'utilisateur avec l'un des niveaux d'accès des autorisations suivants :

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

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
users[]

string

Facultatif. Noms de ressources de tous les utilisateurs humains dans la discussion de groupe avec l'utilisateur appelant. Les applications de chat ne peuvent pas être incluses dans la requête.

Le nombre maximal d'utilisateurs pouvant être spécifiés dans une seule requête est 49.

Format : users/{user}, où {user} correspond à l'id de la personne issue de l'API People ou à l'id de l'utilisateur dans l'API Directory. Par exemple, pour trouver toutes les discussions de groupe avec l'utilisateur appelant et deux autres utilisateurs, avec les ID de profil de l'API People 123456789 et 987654321, vous pouvez utiliser users/123456789 et users/987654321. Vous pouvez également utiliser l'adresse e-mail comme alias pour {user}. Par exemple, users/example@gmail.com, où example@gmail.com est l'adresse e-mail de l'utilisateur Google Chat.
pageSize

integer

Facultatif. Nombre maximal d'espaces à renvoyer. Le service peut renvoyer une valeur inférieure.

Si aucune valeur n'est spécifiée, 10 espaces au maximum sont renvoyés.

La valeur maximale est 30. Si vous utilisez une valeur supérieure à 30, elle est automatiquement remplacée par 30.

Les valeurs négatives renvoient une erreur INVALID_ARGUMENT.
pageToken

string

Facultatif. Jeton de page reçu d'un appel précédent pour trouver des discussions de groupe. Fournissez ce paramètre pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis doivent correspondre à l'appel ayant fourni le jeton. La transmission de valeurs différentes peut entraîner des résultats inattendus.
spaceView

enum (SpaceView)

Type d'affichage de l'espace demandé. Si aucune valeur n'est définie, la valeur par défaut est SPACE_VIEW_RESOURCE_NAME_ONLY. Les requêtes qui spécifient SPACE_VIEW_EXPANDED doivent inclure des niveaux d'accès qui permettent de lire les données d'espace, par exemple https://www.googleapis.com/auth/chat.spaces ou https://www.googleapis.com/auth/chat.spaces.readonly.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse contenant des espaces de discussion de groupe avec exactement l'utilisateur appelant et les utilisateurs demandés.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "spaces": [
    {
      object (Space)
    }
  ],
  "nextPageToken": string
}
Champs
spaces[]

object (Space)

Liste des espaces sur la page demandée (ou la première page).
nextPageToken

string

Jeton que vous pouvez envoyer en tant que pageToken pour récupérer la page de résultats suivante. Si ce champ est vide, il n'y a pas d'autres pages.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès des autorisations OAuth suivants :

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

Pour en savoir plus, consultez le guide sur l'autorisation.

SpaceView

Vue qui spécifie les champs à renseigner dans la ressource Space. Pour assurer la compatibilité avec les futures versions, nous vous recommandons de tenir compte des valeurs supplémentaires dans votre code.

Enums
SPACE_VIEW_UNSPECIFIED Valeur par défaut / non définie.
SPACE_VIEW_RESOURCE_NAME_ONLY Ne renseigne que le nom de la ressource Space.
SPACE_VIEW_EXPANDED Renseigne les champs de la ressource Space. Remarque : Le champ permissionSettings ne sera pas renseigné. Les requêtes qui spécifient SPACE_VIEW_EXPANDED doivent inclure des niveaux d'accès qui permettent de lire les données d'espace, par exemple https://www.googleapis.com/auth/chat.spaces ou https://www.googleapis.com/auth/chat.spaces.readonly.