Créer une section

Ce guide explique comment utiliser la méthode create sur la ressource Section de l'API Google Chat pour créer une section personnalisée dans Google Chat.

Les sections aident les utilisateurs à regrouper leurs conversations et à personnaliser la liste des espaces affichés dans le panneau de navigation Google Chat. Pour en savoir plus, consultez Créer et organiser des sections dans Google Chat.

Prérequis

Python

Créer une section

Pour créer une section avec authentification de l'utilisateur, transmettez les éléments suivants dans votre requête :

  • Spécifiez le champ d'application de l'autorisation chat.users.sections.
  • Appelez la méthode CreateSection.
  • Dans le corps de la requête, indiquez une ressource Section :
    • Définissez displayName sur le nom de la section (80 caractères maximum).
    • Définissez type sur CUSTOM_SECTION.

L'exemple suivant crée une section :

Python

from google.cloud import chat_v1

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

    # Initialize request
    request = chat_v1.CreateSectionRequest(
        parent="users/me",
        section=chat_v1.Section(
            display_name="SECTION_DISPLAY_NAME",
            type=chat_v1.Section.SectionType.CUSTOM_SECTION
        )
    )

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

    print(response)

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

  • SECTION_DISPLAY_NAME : nom de la nouvelle section.

L'API Chat renvoie une instance de Section qui détaille la section créée.