Synup
Crear clave
v1Recursos/Connections/postMover una cuenta de fichas al nivel de agencia

Mover una cuenta de fichas al nivel de agencia

Mueve la cuenta de fichas de Google o Facebook de un cliente al nivel de agencia, para que sus fichas se puedan asignar a ubicaciones de cualquier cliente de tu agencia. No se vuelve a conectar nada y nadie tiene que iniciar sesión de nuevo: las ubicaciones que la cuenta ya atiende siguen conectadas con el mismo inicio de sesión. Si tu agencia ya tiene una cuenta a nivel de agencia para el mismo inicio de sesión de Google o Facebook, esta se fusiona con ella. Sus fichas y cuentas publicitarias pasan a la cuenta existente, y la cuenta que moviste se archiva. Envía primero dryRun con true para ver qué pasaría sin cambiar nada. Necesitas un token con acceso a todos los clientes; un token limitado a clientes específicos recibe 403. Devuelve 400 para cualquier cosa que no sea una cuenta de fichas de Google o Facebook (las cuentas sociales a nivel de marca y la conexión de una sola ubicación no se pueden mover), 404 cuando la conexión no existe o está archivada, y 409 cuando la cuenta ya está a nivel de agencia.

post/api/v1/connections/move-to-agency
connections:write
Cuerpo de la solicitud
connectionIdstringobligatorio
El id de la cuenta de fichas que quieres mover. Usa la conexión propia de la cuenta, no la conexión de una de sus ubicaciones.
dryRunbooleanopcional
Ponlo en true para ver una vista previa del movimiento sin hacerlo. La respuesta tiene los mismos campos, sin moved.
Respuesta
dataobjectopcional
movedboolean (true)opcional
Siempre true después de un movimiento real. No se incluye en una prueba.
accountIdstringopcional
La cuenta que pediste mover. Después de una fusión, esta cuenta queda archivada y mergeIntoId es la cuenta que debes usar a partir de entonces.
mergeIntoIdstringopcional
La cuenta existente a nivel de agencia con la que se fusiona esta, o null cuando la cuenta se mueve por sí sola.
mergeIntoNamestringopcional
El nombre visible de la cuenta con la que se fusiona, o null cuando no hay fusión.
locationCountintegeropcional
Cuántas ubicaciones conectadas atiende la cuenta, contadas antes del movimiento.
clientCountintegeropcional
A cuántos clientes pertenecen esas ubicaciones.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
409La solicitud entra en conflicto con el estado actual del recurso — por ejemplo, cambiar el correo electrónico o el teléfono de un destinatario al que ya se le ha enviado un mensaje, o una invitación de equipo que ya fue aceptada (o que aún no ha sido aceptada).
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/connections/move-to-agency
Su clave de API
Cuerpo de la solicitud*
{}

Guías que usan este recurso