Ce guide explique comment utiliser la méthode create
sur la ressource Reaction
.
de l'API Google Chat pour ajouter une réaction à un message, comme 👍, Membership et Comparison.
La
Ressource Reaction
représente un emoji que les utilisateurs peuvent utiliser pour réagir à un message, comme 👍, DNSSEC,
et 🙌.
Prérequis
Python
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Configurez votre environnement:
- Créez un projet Google Cloud.
- Configurer l'écran de consentement OAuth
- activer et configurer l'API Google Chat à l'aide d'un nom ; et la description de votre application Chat.
- Installez la Python Bibliothèque cliente des API Google.
-
Créez des identifiants client OAuth pour une application de bureau. Pour exécuter l'exemple
enregistrez les identifiants dans un fichier JSON nommé
client_secrets.json
dans votre fichier dans votre répertoire local.
- Choisissez un niveau d'autorisation compatible avec l'authentification des utilisateurs.
Ajouter une réaction à un message
Pour créer une réaction à un message, transmettez les éléments suivants dans votre requête:
- Spécifiez
chat.messages.reactions.create
,chat.messages.reactions
ou Champ d'application de l'autorisationchat.messages
. - Appelez la méthode
Méthode
create
le RessourceReaction
. - Définissez
parent
sur le nom de ressource du message auquel réagir. - Définissez
body
(le corps de la requête) sur une instance deReaction
dans lequel le champunicode
est un emoji standard représenté par un Unicode .
L'exemple suivant réagit à un message avec l'emoji suivant:
Python
- Dans votre répertoire de travail, créez un fichier nommé
chat_reaction_create.py
. Ajoutez le code suivant dans
chat_reaction_create.py
:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.messages.reactions.create"] def main(): ''' Authenticates with Chat API via user credentials, then creates a reaction to a message. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().messages().reactions().create( # The message to create a reaction to. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MESSAGE with a message name. # Obtain the message name from the response body returned # after creating a message asynchronously with Chat REST API. parent = 'spaces/SPACE/messages/MESSAGE', # The reaction to the message. body = { 'emoji': { # A standard emoji represented by a unicode string. 'unicode': '😀' } } ).execute() # Prints details about the created reaction. print(result) if __name__ == '__main__': main()
Dans le code, remplacez les éléments suivants:
SPACE
:name
de l'espace où s'affiche. Vous pouvez l'obtenir à partir du Méthodespaces.list
dans l'API Chat ou depuis l'URL d'un espace.MESSAGE
: nom du message, que vous pouvez obtenir à partir du corps de la réponse renvoyé après la création d'un message de manière asynchrone. à l'aide de l'API Chat ou nom personnalisé attribué au message lors de sa création.
Dans votre répertoire de travail, créez et exécutez l'exemple:
python3 chat_reaction_create.py
L'API Chat renvoie une instance de
Reaction
qui détaille la réaction créée.