Google Calendar
Comment créer un compte de service
Pour cela, vous devez créer votre propre compte dans les services Google.
Accédez à ce lien et créez un nouveau projet :
Trouvez un nom pour le projet :
Appuyez sur « Créer » et attendez un peu pendant que le projet est créé.
Rechargez la page puis cliquez sur le projet que vous venez de créer. Vérifiez dans le champ à gauche votre statut d’accès — il doit indiquer « Propriétaire (1) » :
Passez maintenant aux paramètres du compte de service :
Là, vous devez ouvrir la section « Comptes de service » et cliquer sur « + Créer un compte de service » :
Saisissez le nom et l’e-mail du compte de service :
Puis choisissez le rôle Propriétaire :
Appuyez sur « Terminé », puis sur « Gérer les clés » dans le projet choisi. Ensuite, cliquez sur « Créer une nouvelle clé »
Choisissez le type de clé JSON et appuyez sur « Créer »
Après la création de la clé, elle est automatiquement enregistrée sur votre ordinateur
Vous devez ensuite la télécharger sur l’hébergement ou dans Salebot et partager le lien vers celle-ci dans les paramètres de requête en transmettant l’URL obtenue dans le paramètre creds_path.
Vous devez maintenant ajouter nos intégrations API. Pour cela, allez ici :
Puis vous devez activer les API et services et rechercher Google Calendar API dans la fenêtre ouverte :
Cliquez sur le résultat de recherche puis sur « Activer » :
Cette étape termine la création de votre compte de service.
Comment télécharger le fichier clé
Allez dans le projet sur Salebot et téléchargez le fichier clé obtenu dans un bloc, par exemple comme ceci :
Appuyez sur « Enregistrer » et passez à la fenêtre de test libre :
Entrez la phrase que vous avez définie comme condition (dans ce cas, c’est « 123 »). Vous obtiendrez en réponse un lien vers le fichier avec les clés :
Vous ne pouvez pas supprimer le bloc, sinon le fichier sera supprimé du serveur et vous devrez l’ajouter à nouveau.
N’oubliez pas de mettre le bloc au type d’état Not, afin qu’il ne vous dérange pas.
Vous pouvez enregistrer ce lien dans une variable ou le transmettre tel quel dans le paramètre creds_path.
Comment trouver l’identifiant du calendrier
Vous pouvez trouver l’identifiant du calendrier existant dans ses paramètres, dans la section « Intégrer le calendrier » :
Comment créer un nouveau calendrier
Vous pouvez créer un nouveau calendrier de deux façons : manuellement et à l’aide d’une fonction.
Création manuelle du calendrier :
Afin de pouvoir ajouter des notes et modifier un calendrier existant (ou créé manuellement), vous devez accorder l’accès au compte de service. Pour cela, ajoutez simplement l’e-mail du compte de service dans les paramètres du calendrier concerné :
Création d’un calendrier à l’aide d’une fonction
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres:
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - créer name - nom du calendrier description - description du calendrier
Paramètres supplémentaires:
time_zone - le fuseau horaire du calendrier. Identifiant de fuseau horaire IANA. Par défaut, c’est Europe/Moscow (GMT+3) location - un emplacement géographique du calendrier sous forme de texte libre
Vous pouvez également donner l’accès à un autre compte, par exemple au vôtre :
owner_email - e-mail du compte qui sera ajouté comme propriétaire du calendrier
Par défaut, le calendrier sera créé dans le compte de service. Pour pouvoir le modifier visuellement depuis votre propre compte, renseignez votre e-mail dans le paramètre owner_email.
Valeurs stockées depuis la réponse JSON
Après une exécution réussie, la fonction renvoie les paramètres suivants que vous pouvez enregistrer et conserver :
{'kind': 'calendar#calendar', 'etag': '"WgASl9FY_5zrEmCZvrt4Qlh6tGQ"', 'id': '[email protected]', 'summary': 'Nom du calendrier’, 'timeZone': 'UTC'}
Enregistrons l’identifiant du calendrier créé : id -> calendar_id
Pour tester, vous pouvez afficher la variable #{custom_answer}.
Si l’e-mail (owner_email) a été transmis, alors après la requête réussie, il faut aller dans votre boîte mail et confirmer l’ajout du calendrier à votre compte :
Comment obtenir les informations sur le calendrier
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres:
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - get_calendar; calendar_id - l’identifiant du calendrier choisi
Valeurs stockées
Après une exécution réussie, la fonction renvoie les paramètres suivants que vous pouvez enregistrer et conserver.
Un exemple de la réponse de la fonction :
{'kind': 'calendar#calendar', 'etag': '"6KN4OTLeoqGGu7Nr5uNIQgCGYsU"', 'id': '[email protected]', 'summary': 'Nom du calendrier', 'timeZone': 'UTC'}
Comment obtenir la liste des calendriers du compte de service
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres:
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - calendars_list
Valeurs stockées
Après une exécution réussie, la fonction renvoie les paramètres suivants que vous pouvez enregistrer et conserver.
Un exemple de la réponse de la fonction :
{
'kind': 'calendar#calendarList',
'etag': '"p32o8pm47rfqf20g"',
'nextSyncToken': 'CLCM2Ifb9PECEi5nc2hlZXRzQGdzaGVldHMtMjU0NzEzLmlhbS5nc2VydmljZWFjY291bnQuY29t',
'items': [
{
'kind': 'calendar#calendarListEntry',
'etag': '"1625235372775000"',
'id': '[email protected]',
'summary': 'AAAAAAAAaa',
'timeZone': 'Asia/Singapore',
'colorId': '17',
'backgroundColor': '#9a9cff',
'foregroundColor': '#000000',
'selected': True,
'accessRole': 'owner',
'defaultReminders': [
]
},
{
'kind': 'calendar#calendarListEntry',
'etag': '"1625235805096000"',
'id': '[email protected]',
'summary': 'AAAAAAAAaa',
'timeZone': 'Asia/Singapore',
'colorId': '21',
'backgroundColor': '#cca6ac',
'foregroundColor': '#000000',
'selected': True,
'accessRole': 'owner',
'defaultReminders': [
]
}
]
}
Comment travailler avec des événements
Ajout rapide d’un événement
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres:
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - quick_add_event; calendar_id - l’identifiant du calendrier choisi; event_name - le nom de l’événement
Un exemple des paramètres :
{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "command": "quick_add_event","event_name": "Incredible Event"}
Valeurs stockées
Après une exécution réussie, la fonction renvoie les paramètres suivants que vous pouvez enregistrer et conserver. Pour pouvoir modifier ultérieurement l’événement créé, il est recommandé d’enregistrer son identifiant : id -> event_id.
Un exemple de la réponse de la fonction :
{
'kind': 'calendar#event',
'etag': '"3253879667088000"',
'id': 'ljp7a3ocp8oorbov9u2cq221s0',
'status': 'confirmed',
'htmlLink': 'https://www.google.com/calendar/event?eid=bGpwN2Ezb2NwOG9vcmJvdjl1MmNxMjIxczAgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw',
'created': '2021-07-22T07:43:53.000Z',
'updated': '2021-07-22T07:43:53.544Z',
'creator': {'email': '[email protected]'},
'organizer': {'email': '[email protected]',
'displayName': 'Testov',
'self': True},
'start': {'dateTime': '2021-07-22T07:43:53Z', 'timeZone': 'UTC'},
'end': {'dateTime': '2021-07-22T08:43:53Z', 'timeZone': 'UTC'},
'iCalUID': '[email protected]',
'sequence': 0,
'reminders': {'useDefault': True},
'eventType': 'default'
}
Comment ajouter un événement
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres :
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - add_event calendar_id - l’identifiant du calendrier choisi event_name - le nom de l’événement
Vous devez également définir l’une des deux options de paramètre : date OU date et heure.
Si l’événement a lieu pendant toute la journée, vous devez indiquer les dates :
start_date - la date de début de l’événement au format JJ.MM.AAAA (par ex. 23.07.2010)
end_date - la date de fin de l’événement au format JJ.MM.AAAA (par ex. 24.07.2010)
Si l’événement a lieu à une heure déterminée, vous devez indiquer la date et l’heure :
start_datetime - la date et l’heure de début de l’événement au format JJ.MM.AAAA HH:MM (par ex. 23.07.2010 12:00)
end_datetime - la date et l’heure de fin de l’événement au format JJ.MM.AAAA HH:MM (par ex. 23.07.2010 13:00)
time_zone - le fuseau horaire de l’événement. Identifiant de fuseau horaire IANA. Par défaut, c’est Europe/Moscow (GMT+3)
Si les fuseaux horaires du calendrier et de l’événement sont différents, alors l’événement avec heure sera ajouté dans le fuseau horaire du calendrier.
Exemple :
Le calendrier est dans le fuseau horaire (tz) Europe/Kyiv +3, et l’événement est ajouté avec le fuseau horaire Europe/Berlin +2. L’heure de l’événement à 12h00 (tz +2) sera ajoutée au calendrier comme 13h00, car à l’heure de Kyiv, 13h00 correspond à 12h00 dans le fuseau +2.
Paramètres supplémentaires :
event_description - la description de l’événement location - l’emplacement géographique de l’événement sous forme de texte libre email_minutes - le délai en minutes avant l’événement pour envoyer une notification aux e-mails des participants popup_minutes - le délai en minutes avant l’événement pour envoyer une notification aux participants sous forme de fenêtre contextuelle
Exemple des paramètres :
{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "command": "add_event", "event_name": "The greatest event of all time", "start_datetime": "27.07.2021 12:00", "end_datetime": "27.07.2021 14:00"}
Valeurs enregistrées à partir de la réponse JSON :
Après une exécution réussie, la fonction renvoie les paramètres suivants que vous pouvez enregistrer et conserver.
Pour modifier ultérieurement l’événement créé, il est recommandé d’enregistrer son identifiant :
id -> event_id
Exemple de réponse de la fonction :
{'kind': 'calendar#event', 'etag': '"3254057128970000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:22:53.109Z', 'summary': 'New Event44', 'description': 'Descri xbb xhjxkv', 'location': 'city London', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': ‘Test’, 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Kyiv}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Kyiv}, 'iCalUID': '[email protected]', 'sequence': 0, 'attendees': [{'email': [email protected]', 'displayName': John, 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default'}
Modification de l’événement
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres obligatoires :
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - update_event; calendar_id - l’identifiant du calendrier; event_id - l’identifiant de l’événement que vous devez modifier
Paramètres facultatifs pour la mise à jour :
Vous pouvez transmettre un seul paramètre, ainsi que plusieurs.
event_name - le nom de l’événement event_description - la description de l’événement email_minutes - le délai en minutes avant l’événement pour envoyer une notification aux e-mails des participants popup_minutes - le délai en minutes avant l’événement pour envoyer une notification aux participants sous forme de fenêtre contextuelle
Si l’événement a lieu pendant toute la journée, vous devez indiquer les dates :
start_date - la date de début de l’événement au format JJ.MM.AAAA (par ex. 23.07.2010) end_date - la date de fin de l’événement au format JJ.MM.AAAA (par ex. 24.07.2010)
Si l’événement a lieu à une heure déterminée, vous devez indiquer la date et l’heure :
start_datetime - la date et l’heure de début de l’événement au format JJ.MM.AAAA HH:MM (par ex. 23.07.2010 12:00) end_datetime - la date et l’heure de fin de l’événement au format JJ.MM.AAAA HH:MM (par ex. 23.07.2010 13:00) time_zone - le fuseau horaire de l’événement. Identifiant de fuseau horaire IANA. Par défaut, c’est Europe/Moscow (GMT+3)
Exemple des paramètres :
{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "event_id": "j1lcpm4q2p9c0cv705alv3brug", "command": "update_event", "event_name": "Edited event", "start_datetime": "27.07.2021 12:00", "end_datetime": "27.07.2021 14:00","popup_minutes": "11","email_minutes": "22"}
Valeurs enregistrées à partir de la réponse JSON :
Après une exécution réussie, la fonction renvoie les paramètres suivants que vous pouvez enregistrer et conserver.
Exemple de réponse de la fonction :
{"kind":"calendar#event","etag":""3276713558524000"","id":"j1lcpm4q2p9c0cv705alv3brug","status":"confirmed","htmlLink":"https://www.google.com/calendar/event?eid=ajFsY3BtNHEycDljMGN2NzA1YWx2M2JydWcgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw","created":"2021-12-01T10:40:11.000Z","updated":"2021-12-01T10:43:16.738Z","summary":"Amazing","creator":{"email":"[email protected]"},"organizer":{"email":"[email protected]","displayName":"Test","self":true},"start":{"dateTime":"2021-12-28T09:00:00Z","timeZone":"Europe/Moscow"},"end":{"dateTime":"2021-12-29T11:00:00Z","timeZone":"Europe/Moscow"},"iCalUID":"[email protected]","sequence":0,"reminders":{"useDefault":false,"overrides":[{"method":"email","minutes":22},{"method":"popup","minutes":12}]},"eventType":"default","update_status":"ok"}
Obtenir une liste d’événements
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres :
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - get_event_list; calendar_id - l’identifiant du calendrier
Si vous ne transmettez pas de paramètres supplémentaires, le résultat sera une liste des événements d’aujourd’hui
Paramètres supplémentaires :
start_date - la date à partir de laquelle vous souhaitez rechercher des événements au format JJ.MM.AAAA (23.07.2021) end_date - la date jusqu’à laquelle vous souhaitez rechercher des événements au format JJ.MM.AAAA (24.07.2021)
Exemple des paramètres :
L’événement du 23 juillet sera trouvé
{"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "[email protected]", "command": "get_event_list", "start_date": "22.07.2021", "end_date": "23.07.2021"}
Valeurs enregistrées à partir de la réponse JSON :
Après une exécution réussie, la fonction renvoie les paramètres suivants que vous pouvez enregistrer et conserver.
La liste des événements trouvés peut être enregistrée dans une variable :
items -> event_list
Exemple de réponse de la fonction :
{'kind': 'calendar#events', 'etag': '"p33odnesrinsv20g"', 'summary': 'Test', 'description': 'Test description', 'updated': '2021-07-23T12:13:05.686Z', 'timeZone': 'UTC', 'accessRole': 'owner', 'defaultReminders': [], 'items': [{'kind': 'calendar#event', 'etag': '"3254084771372000"', 'id': '6d8rocb9e2r21ue37jgsa0v06i', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=NmQ4cm9jYjllMnIyMXVlMzdqZ3NhMHYwNmkgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T12:11:13.000Z', 'updated': '2021-07-23T12:13:05.686Z', 'summary': 'DDDDDDDDD', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Testov', 'self': True}, 'start': {'date': '2021-07-20'}, 'end': {'date': '2021-07-21'}, 'transparency': 'transparent', 'iCalUID': '[email protected]', 'sequence': 0, 'reminders': {'useDefault': False}, 'eventType': 'default'}]}
Comment déplacer des événements vers un autre calendrier
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres :
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - move_event; calendar_id - l’identifiant du calendrier depuis lequel l’événement est déplacé; event_id - l’identifiant de l’événement; destination_calendar_id - l’identifiant du calendrier vers lequel l’événement est déplacé;
Valeurs enregistrées à partir de la réponse JSON :
Après une exécution réussie, la fonction renvoie les paramètres suivants que vous pouvez enregistrer et conserver.
Exemple de réponse de la fonction :
{'kind': 'calendar#event', 'etag': '"3253880350568000"', 'id': 'ljp7a3ocp8oorbov9u2cq221s0', 'status': 'cancelled', 'htmlLink': 'https://www.google.com/calendar/event?eid=bGpwN2Ezb2NwOG9vcmJvdjl1MmNxMjIxczAgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-22T07:43:53.000Z', 'updated': '2021-07-22T07:49:35.284Z', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Тестовый календарь'}, 'start': {'dateTime': '2021-07-22T07:43:53Z', 'timeZone': 'UTC'}, 'end': {'dateTime': '2021-07-22T08:43:53Z', 'timeZone': 'UTC'}, 'iCalUID': '[email protected]', 'sequence': 0, 'reminders': {'useDefault': True}, 'eventType': 'default'}
Comment obtenir des informations sur l’événement
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres :
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - get_event; calendar_id - l’identifiant du calendrier; event_id - l’identifiant de l’événement
Valeurs enregistrées à partir de la réponse JSON :
Après une exécution réussie, la fonction renvoie les paramètres suivants que vous pouvez enregistrer et conserver.
Exemple de réponse de la fonction :
{'kind': 'calendar#event', 'etag': '"3254067331414000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T11:12:55.553Z', 'summary': 'New Event44', 'description': 'Descri xbb xhjxkv', 'location': 'city London', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Test', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': '[email protected]', 'sequence': 0, 'attendees': [{'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default'}
Comment supprimer un événement
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres :
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - remove_event; calendar_id - l’identifiant du calendrier; event_id - l’identifiant de l’événement que vous voulez supprimer
Valeurs enregistrées à partir de la réponse JSON :
Après une exécution réussie, la fonction renvoie les paramètres suivants que vous pouvez enregistrer et conserver.
Exemple de réponse de la fonction :
{'status': 'ok'}
Comment ajouter un participant à un événement
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres :
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - add_client; calendar_id - l’identifiant du calendrier; event_id - l’identifiant de l’événement; client_email - l’e-mail du client que vous voulez ajouter
Paramètres supplémentaires :
name - le nom de l’événement; comment - commentaire du participant
Exemple des paramètres :
{
"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",
"calendar_id": "[email protected]",
"command": "add_client",
"event_id": "#{event_id}",
"client_email": "[email protected]",
"name": "John",
"comment": "Je serai le premier !"
}
Valeurs enregistrées à partir de la réponse JSON :
La fonction renvoie toujours le statut add_status. Il peut prendre l’une de trois valeurs :
'ok' - le client a été ajouté exist - le client existe déjà error - une erreur s’est produite pendant le processus d’ajout ; en plus de add_status, il y aura alors un paramètre error_message avec le texte de l’erreur
Exemple de réponse de la fonction en cas de succès :
{'kind': 'calendar#event', 'etag': '"3254059247409000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:58:11.548Z', 'summary': 'New Event44', 'description': 'Descri xbb xhjxkv', 'location': 'city London', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Test', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': '[email protected]', 'sequence': 0, 'attendees': [{'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}, {'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}, {'email': '[email protected]', 'displayName': 'John2', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default', ‘add_status’: 'ok'}
Comment supprimer un participant
URL de la fonction: https://store.salebot.ai/function/gcalendar Type de requête: POST-json
Paramètres :
creds_path - le lien vers la clé d’accès du compte de service à l’API du calendrier (obtenu en suivant l’instruction ci-dessus) ; la commande - remove_client; calendar_id - l’identifiant du calendrier; event_id - l’identifiant de l’événement; client_email - l’e-mail du client
Exemple des paramètres :
{
"creds_path": "https://files.salebot.ai/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",
"calendar_id": "[email protected]",
"command": "remove_client",
"event_id": "#{event_id}",
"client_email": "[email protected]"
}
Valeurs enregistrées à partir de la réponse JSON :
La fonction renvoie toujours le statut remove_status. Il peut prendre l’une de trois valeurs :
1 - le client a été supprimé avec succès 0 - le client n’a pas été trouvé error - une erreur s’est produite pendant le processus de suppression ; en plus de remove_status, il y aura alors un paramètre error_message avec le texte de l’erreur
La réponse de la fonction en cas de succès :
{'kind': 'calendar#event', 'etag': '"3254059247409000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:58:11.548Z', 'summary': 'New Event44', 'description': 'Descri xbb xhjxkv', 'location': 'city London', 'creator': {'email': '[email protected]'}, 'organizer': {'email': '[email protected]', 'displayName': 'Test', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': '[email protected]', 'sequence': 0, 'attendees': [{'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}, {'email': '[email protected]', 'displayName': 'John', 'responseStatus': 'needsAction'}, {'email': '[email protected]', 'displayName': 'John2', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default', 'remove_status': '1'}
Mis à jour