Synup
Créer une clé
v1Ressources/Connexions/postDéplacer un compte de fiches au niveau de l'agence

Déplacer un compte de fiches au niveau de l'agence

Déplace le compte de fiches Google ou Facebook d'un client au niveau de l'agence, pour que ses fiches puissent être attribuées aux établissements de n'importe quel client de votre agence. Rien n'est reconnecté et personne n'a à se reconnecter : les établissements que le compte dessert déjà restent connectés via la même connexion. Si votre agence possède déjà un compte au niveau de l'agence pour la même connexion Google ou Facebook, ce compte y est fusionné. Ses fiches et ses comptes publicitaires passent au compte existant, et le compte déplacé est archivé. Envoyez d'abord dryRun à true pour voir ce qui se passerait sans rien modifier. Un jeton ayant accès à tous les clients est nécessaire ; un jeton limité à certains clients reçoit 403. Renvoie 400 pour tout ce qui n'est pas un compte de fiches Google ou Facebook (les comptes sociaux au niveau de la marque et la connexion d'un seul établissement ne peuvent pas être déplacés), 404 lorsque la connexion n'existe pas ou est archivée, et 409 lorsque le compte est déjà au niveau de l'agence.

post/api/v1/connections/move-to-agency
connections:write
Corps de la requête
connectionIdstringobligatoire
L'id du compte de fiches à déplacer. Utilisez la connexion du compte lui-même, pas celle de l'un de ses établissements.
dryRunbooleanfacultatif
Mettez true pour prévisualiser le déplacement sans l'effectuer. La réponse contient les mêmes champs, sans moved.
Réponse
dataobjectfacultatif
movedboolean (true)facultatif
Toujours true après un déplacement réel. Absent lors d'une simulation.
accountIdstringfacultatif
Le compte dont vous avez demandé le déplacement. Après une fusion, ce compte est archivé et mergeIntoId désigne le compte à utiliser désormais.
mergeIntoIdstringfacultatif
Le compte existant au niveau de l'agence dans lequel celui-ci est fusionné, ou null lorsque le compte est déplacé seul.
mergeIntoNamestringfacultatif
Le nom affiché du compte dans lequel il est fusionné, ou null en l'absence de fusion.
locationCountintegerfacultatif
Le nombre d'établissements connectés que le compte dessert, compté avant le déplacement.
clientCountintegerfacultatif
Le nombre de clients auxquels appartiennent ces établissements.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
409La requête entre en conflit avec l'état actuel de la ressource — par exemple, modifier l'e-mail ou le téléphone d'un destinataire à qui un message a déjà été envoyé, ou une invitation d'équipe déjà acceptée (ou pas encore acceptée).
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/connections/move-to-agency
Votre clé API
Corps de la requête*
{}

Guides qui utilisent cette ressource