Modifier la position d'une section

Ce guide explique comment utiliser la position méthode sur la Section ressource de l'API Google Chat pour modifier l'ordre de tri d'une section dans Google Chat.

Pour en savoir plus, consultez Créer et organiser des sections dans Google Chat.

Prérequis

Python

Modifier la position d'une section

Pour modifier la position d'une section avec l'authentification des utilisateurs, transmettez les éléments suivants dans votre requête :

  • Spécifiez le champ d'application d'autorisation chat.users.sections.
  • Appelez la PositionSection méthode.
  • Dans le corps de la requête, spécifiez le name de la section à positionner et la nouvelle position :
    • Définissez sortOrder sur une position absolue (supérieure à 0).
    • OU définissez relativePosition sur START ou END.

L'exemple suivant déplace une section au début de la liste :

Python

from google.cloud import chat_v1

def position_section():
    # Create a client
    client = chat_v1.ChatServiceClient()

    # Initialize request
    request = chat_v1.PositionSectionRequest(
        name="SECTION_NAME",
        relative_position=chat_v1.PositionSectionRequest.Position.START
    )

    # Make the request
    response = client.position_section(request=request)

    print(response)

Pour exécuter cet exemple, remplacez les éléments suivants :

  • SECTION_NAME : nom de ressource de la section. Vous pouvez obtenir le nom de ressource en appelant la ListSections méthode.

L'API Chat renvoie l'instance mise à jour de Section.