Method: users.sections.position

Modifie l'ordre de tri d'une section. Pour en savoir plus, consultez Créer et organiser des sections dans Google Chat.

Nécessite une authentification de l'utilisateur avec le champ d'application de l'autorisation :

  • https://www.googleapis.com/auth/chat.users.sections

Requête HTTP

POST https://chat.googleapis.com/v1/{name=users/*/sections/*}:position

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource de la section à positionner.

Format : users/{user}/sections/{section}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{

  "sortOrder": integer,
  "relativePosition": enum (Position)
}
Champs
Obligatoire. Nouvelle position de la section. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
sortOrder

integer

Facultatif. Position absolue de la section dans la liste des sections. La position doit être supérieure à 0. Si la position est supérieure au nombre de sections, la section est ajoutée à la fin de la liste. Cette opération insère la section à la position indiquée et déplace la section d'origine à cette position, ainsi que celles qui se trouvent en dessous, à la position suivante.
relativePosition

enum (Position)

Facultatif. Position relative de la section dans la liste des sections.
Fin des champs qui s'excluent mutuellement.

Corps de la réponse

Message de réponse pour le positionnement d'une section.

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

Représentation JSON 
{
  "section": {
    object (Section)
  }
}
Champs
section

object (Section)

Section modifiée.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/chat.users.sections

Pour en savoir plus, consultez le guide d'autorisation.

Position

Position de la section.

Enums
POSITION_UNSPECIFIED Position non spécifiée.
START Début de la liste des sections.
END Fin de la liste des sections.