Transferir unidades

Com a API My Business Account Management, você pode transferir unidades para outras contas ou grupos de unidades. Leia as instruções nesta documentação para saber como fazer isso.

Observação: para transferir uma unidade, o autor da chamada precisa ser o proprietário dela, e o proprietário da conta de destino precisa ser pelo menos administrador dessa unidade. Para saber como conceder a propriedade de uma ficha da empresa, consulte Gerenciar administradores de contas e unidades.

Primeiras etapas

Os seguintes requisitos precisam ser atendidos para transferir unidades:

Conta de origem: a conta de origem é a conta proprietária da unidade e pode ser uma conta pessoal ou um grupo de unidades. Depois que a transferência for concluída, a conta de origem não terá mais acesso à unidade.
Conta de destino: a conta de destino é a conta para que a unidade será transferida e pode ser uma conta pessoal ou um grupo de unidades. Depois que a transferência for concluída, a conta de destino será a proprietária principal da unidade.
Tokens de atualização/acesso do OAuth2: as contas de origem e de destino precisam ter tokens de atualização/acesso do OAuth2 para chamar a API.

Transferir unidades

Observação: os Perfis de Empresas têm um período experimental para administradores de unidades. Depois que um usuário é adicionado a um perfil como proprietário ou gerente, por sete dias ele poderá realizar apenas algumas operações limitadas em relação à unidade e aos usuários dela e também não poderá transferir a propriedade principal de um perfil para si mesmo ou para um terceiro usuário.

Para transferir unidades, siga estas etapas:

1. Você precisará se tornar o proprietário da unidade. Use as credenciais de OAuth do proprietário atual da empresa para chamar account.admins.create e convidar um usuário a ser proprietário da ficha. Em seguida, use as credenciais de OAuth do usuário convidado para chamar accounts.invitations.list e conseguir o ID do convite. Chame accounts.invitations.accept para aceitar esse convite.

   Observação: o destinatário não pode ser membro de uma conta da organização ou de um grupo de usuários.

2. Use as credenciais de OAuth da conta de destino para chamar accounts.list. Em seguida, encontre na lista o ID da conta para a qual a unidade será transferida. O ID de administrador na resposta à chamada de account.admins.create ou accounts.invitations.list na etapa 1 também pode ser usado como o ID da conta. Esse ID pode ser de uma conta pessoal ou um grupo de unidades.

3. Use o ID da conta recuperado na etapa 2 como a conta de destino no campo destinationAccount do corpo da solicitação, que pode ser usado para chamar locations.transfer.

   Observação: depois que a transferência for concluída, a conta de destino será a conta principal associada ao proprietário da ficha. Se o resultado gerado não for o pretendido, repita as etapas de 1 a 3 com um novo usuário. Depois, transfira a unidade de volta para a conta principal original. Use o endpoint accounts.admins.patch para fazer downgrade do papel de administrador da conta de destino original.

Use as credenciais de OAuth da conta de destino para chamar accounts.locations.list e verificar se a unidade transferida aparece nos resultados. Se você chamar o endpoint accounts.locations.list com a conta de origem, a unidade transferida não será incluída nos resultados.

Transferir para um grupo de unidades

Para transferir uma unidade para um location group na organização, chame locations.admins.create usando as credenciais de OAuth de merchant. Use o campo account no recurso Admin para transmitir location group account ID com o role apropriado. Use as credenciais de administrador de location group para chamar accounts.invitations.list usando o ID da conta do grupo de unidades como o argumento parent para recuperar convites relacionados a location group. Encontre o convite que tem a unidade desejada correta e chame accounts.invitations.accept para aceitar esse convite.