Modifier une section

Ce guide explique comment utiliser la patch méthode sur la ressource Section de l'API Google Chat pour mettre à jour une section personnalisée dans Google Chat.

Seules les sections de type CUSTOM_SECTION peuvent être mises à jour. Pour en savoir plus, consultez Créer et organiser des sections dans Google Chat.

Prérequis

Python

Mettre à jour une section

Pour mettre à jour 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 UpdateSection méthode.
  • Dans le corps de la requête, fournissez une ressource Section et un masque de champ :
    • Définissez le name de la section à mettre à jour.
    • Définissez displayName sur le nouveau nom de la section.
    • Définissez updateMask sur displayName.

L'exemple suivant met à jour une section :

Python

from google.cloud import chat_v1
from google.protobuf import field_mask_pb2

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

    # Initialize request
    request = chat_v1.UpdateSectionRequest(
        section=chat_v1.Section(
            name="SECTION_NAME",
            display_name="NEW_SECTION_DISPLAY_NAME"
        ),
        update_mask=field_mask_pb2.FieldMask(paths=["display_name"])
    )

    # Make the request
    response = client.update_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.
  • NEW_SECTION_DISPLAY_NAME : nouveau nom de la section.

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