Ce guide explique comment utiliser la
list
méthode sur la SectionItem ressource 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
- Configurez votre environnement :
- Créez un projet Google Cloud.
- Configurez l'écran d'autorisation OAuth.
- Activez et configurez l'API Google Chat avec un nom, une icône et une description pour 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 dans un 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 dans une section
Pour lister les espaces 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.sectionsouchat.users.sections.readonly. - Appelez la
ListSectionItemsméthode. - 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 laListSectionsméthode.
L'API Chat renvoie une liste de
SectionItem ressources.
Articles associés
- Créer une section
- Mettre à jour une section
- Supprimer une section
- Modifier l'ordre d'affichage d'une section
- Lister les sections
- Déplacer un espace vers une autre section