Synup
Criar chave
v1Recursos/Connections/postMover uma conta de perfis para o nível da agência

Mover uma conta de perfis para o nível da agência

Move a conta de perfis do Google ou do Facebook de um cliente para o nível da agência, para que seus perfis possam ser atribuídos a locais de qualquer cliente da sua agência. Nada é reconectado e ninguém precisa entrar de novo: os locais que a conta já atende continuam conectados pelo mesmo login. Se a sua agência já tiver uma conta no nível da agência para o mesmo login do Google ou do Facebook, esta conta é mesclada a ela. Os perfis e as contas de anúncios passam para a conta existente, e a conta movida é arquivada. Envie primeiro dryRun como true para ver o que aconteceria sem alterar nada. É preciso um token com acesso a todos os clientes; um token limitado a clientes específicos recebe 403. Retorna 400 para qualquer coisa que não seja uma conta de perfis do Google ou do Facebook (contas sociais no nível da marca e a conexão de um único local não podem ser movidas), 404 quando a conexão não existe ou está arquivada e 409 quando a conta já está no nível da agência.

post/api/v1/connections/move-to-agency
connections:write
Corpo da solicitação
connectionIdstringobrigatório
O id da conta de perfis a mover. Use a conexão da própria conta, não a conexão de um dos seus locais.
dryRunbooleanopcional
Defina como true para visualizar a mudança sem realizá-la. A resposta traz os mesmos campos, sem moved.
Resposta
dataobjectopcional
movedboolean (true)opcional
Sempre true após uma mudança real. Não é incluído em uma simulação.
accountIdstringopcional
A conta que você pediu para mover. Após uma mesclagem, esta conta fica arquivada e mergeIntoId passa a ser a conta a usar.
mergeIntoIdstringopcional
A conta existente no nível da agência à qual esta é mesclada, ou null quando a conta é movida sozinha.
mergeIntoNamestringopcional
O nome de exibição da conta à qual ela é mesclada, ou null quando não há mesclagem.
locationCountintegeropcional
Quantos locais conectados a conta atende, contados antes da mudança.
clientCountintegeropcional
A quantos clientes esses locais pertencem.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
409A solicitação entra em conflito com o estado atual do recurso — por exemplo, alterar o e-mail ou telefone de um destinatário que já recebeu uma mensagem, ou um convite de equipe que já foi aceito (ou que ainda não foi aceito).
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/connections/move-to-agency
Sua chave de API
Corpo da solicitação*
{}

Guias que usam este recurso