Ce guide explique comment utiliser la méthode list sur la ressource SectionItem de l'API Google Chat pour lister les éléments (tels que les espaces) d'une section.
Seuls les espaces peuvent être des éléments de section. Pour en savoir plus, consultez Créer et organiser des sections dans Google Chat.
Prérequis
Python
- Compte Google Workspace Business ou Enterprise ayant accès à Google Chat.
- Configurez votre environnement :
- Créez un projet Google Cloud.
- Configurer l'écran de consentement OAuth
- Activez et configurez l'API Google Chat en attribuant un nom, une icône et une description à votre application Chat.
- Installez la bibliothèque cliente Cloud Python.
-
Créez des identifiants d'ID client OAuth pour une application de bureau. Pour exécuter l'exemple de ce guide, enregistrez les identifiants sous forme de fichier JSON nommé
credentials.jsondans votre répertoire local.
- Choisissez un champ d'application d'autorisation compatible avec l'authentification des utilisateurs.
Lister les espaces d'une section
Pour lister les espaces d'une section avec authentification de l'utilisateur, transmettez les éléments suivants dans votre requête :
- Indiquez le champ d'application de l'autorisation
chat.users.sectionsouchat.users.sections.readonly. - Appelez la méthode
ListSectionItems. - Définissez
parentsur le nom de ressource de la section.
L'exemple suivant liste les espaces d'une section :
Python
from google.cloud import chat_v1
def list_section_items():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.ListSectionItemsRequest(
parent="SECTION_NAME"
)
# Make the request
page_result = client.list_section_items(request=request)
# Handle the response
for item in page_result:
print(item)
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 méthodeListSections.
L'API Chat renvoie une liste de ressources SectionItem.
Articles associés
- Créer une section
- Modifier une section
- Supprimer une section
- Modifier la position d'une section
- Lister les sections
- Déplacer un espace vers une autre section