Créer une section

Ce guide explique comment utiliser la create méthode sur la Section ressource de l'API Google Chat pour créer une nouvelle rubrique 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 d'autorisation chat.users.sections.
  • Appelez la CreateSection méthode.
  • Dans le corps de la requête, fournissez une ressource Section :
    • Définissez displayName sur un nom pour la section (jusqu'à 80 caractères).
    • 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.