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.

Requiert l'authentification de l'utilisateur avec le niveau d'accès des autorisations suivant :

  • 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
Champ d'union position. Obligatoire. Nouvelle position de la section. position ne peut être qu'un des éléments suivants :
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, vers la position suivante.
relativePosition

enum (Position)

Facultatif. Position relative de la section dans la liste des sections.

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 mise à jour.

Niveaux d'accès 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 sur l'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.