Révoque un message d'agent qui a été envoyé, mais pas encore distribué.
Si la plate-forme RCS for Business révoque un message, celui-ci est supprimé de la file d'attente des messages de l'utilisateur et n'est jamais distribué (200 OK).
Une réponse "404 Not Found" (404 Introuvable) signifie que la tentative de révocation a échoué, car le message a été distribué.
Il est possible que l'agent lance une révocation pendant que la plate-forme RCS for Business est en train de distribuer le message. Dans ces rares cas, l'agent reçoit un événement utilisateur DELIVERED pour le message peu de temps après avoir lancé la demande de révocation.
Requête HTTP
DELETE https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*/agentMessages/*}
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres | |
|---|---|
name |
"phones/{E.164}/agentMessages/{messageId}", où {E.164} correspond au numéro de téléphone de l'utilisateur au format E.164 et {messageId} à l'ID attribué par l'agent au message de l'agent qui doit être révoqué. Par exemple, avec le numéro de téléphone américain +1-222-333-4444 et un message d'agent avec l'ID "12345xyz", le point de terminaison obtenu serait https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz. |
Paramètres de requête
| Paramètres | |
|---|---|
agentId |
Obligatoire. Identifiant unique de l'agent. |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse est un objet JSON vide.
Niveaux d'accès des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/rcsbusinessmessaging
Pour plus d'informations, consultez la OAuth 2.0 Overview.