Ce guide explique comment utiliser la
move
méthode sur la SectionItem ressource de l'API Google Chat pour déplacer un élément (tel qu'un espace) d'une section à une autre.
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.
- 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.
Déplacer un espace vers une autre section
Pour déplacer un espace vers une autre 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
MoveSectionItemméthode. - Dans le corps de la requête, spécifiez le
namede l'élément de section à déplacer et letargetSection:- Définissez
namesur le nom de ressource de l'élément de section (par exemple,users/me/sections/default-spaces/items/spaces/123456). - Définissez
targetSectionsur le nom de ressource de la section vers laquelle vous souhaitez déplacer l'élément.
- Définissez
L'exemple suivant déplace un espace vers une autre section :
Python
from google.cloud import chat_v1
def move_section_item():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.MoveSectionItemRequest(
name="SECTION_ITEM_NAME",
target_section="TARGET_SECTION_NAME"
)
# Make the request
response = client.move_section_item(request=request)
print(response)
Pour exécuter cet exemple, remplacez les éléments suivants :
SECTION_ITEM_NAME: nom de ressource de l'élément de section.TARGET_SECTION_NAME: nom de ressource de la section cible.
L'API Chat renvoie l'instance mise à jour de
SectionItem.
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
- Lister les espaces dans une section