Transferir unidades

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

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

Primeiras etapas

Os seguintes requisitos precisam ser atendidos para transferir locais:

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 locais

Observação: os Perfis de Empresa têm um período experimental para administradores de locais. 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 ao local e aos usuários dele e também não poderá transferir a propriedade principal de um perfil para si mesmo ou para um terceiro usuário.

Para transferir locais, siga estas etapas:

1. Você precisará se tornar o proprietário do local. 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 o local será transferido. 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 locais.

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 o local de volta para a conta principal original. Use o endpoint accounts.admins.patch para fazer downgrade da função de administrador da conta de destino original.

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

Transferir para um grupo de locais

Para transferir um local 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 locais como o argumento parent para recuperar convites relacionados a location group. Encontre o convite que tem o local desejado correto e chame accounts.invitations.accept para aceitar esse convite.