Перенос адресов

С помощью My Business Account Management API вы можете переносить адреса в разные аккаунты или группы адресов. О том, как это сделать, читайте ниже.

Примечание. Перенести адрес может только его владелец. При этом владелец целевого аккаунта должен быть как минимум администратором этого адреса. Сведения о том, как предоставить пользователю право собственности, можно найти в статье Управление администраторами для аккаунтов и адресов.

Начало работы

Для переноса адресов необходимо следующее:

Исходный аккаунт, у которого есть право собственности на нужный адрес. Это может быть как личный аккаунт, так и группа адресов. После завершения процесса у исходного аккаунта больше не будет доступа к перенесенному адресу.
Целевой аккаунт, куда необходимо добавить адрес. Это может быть как личный аккаунт, так и группа адресов. После завершения процесса целевой аккаунт получит права основного владельца.
Токены OAuth2 для доступа или обновления. Эти токены необходимы как для исходного, так и для целевого аккаунта. Они требуются для вызова API.

Перенос адресов

Примечание. Для тех, кто управляет адресами в профилях компаний, предусмотрен испытательный срок. После того как пользователь будет добавлен в качестве владельца или администратора профиля, в течение семи дней его доступ к действиям с другими пользователями адреса и самим адресом будет ограничен. В частности, пользователь не сможет изменять основного владельца профиля.

Чтобы перенести адреса, выполните следующие действия:

1. Если вы не являетесь владельцем адреса, получите эти права. Используйте учетные данные OAuth текущего владельца, чтобы вызвать account.admins.create и отправить пользователю приглашение стать владельцем. Затем используйте учетные данные OAuth приглашенного пользователя, чтобы отправить вызов accounts.invitations.list и получить идентификатор приглашения. Вызовите accounts.invitations.accept, чтобы принять приглашение.

   Примечание. Получатель не должен быть участником организации или относиться к принадлежащей ей группе пользователей.

2. Используйте учетные данные OAuth целевого аккаунта, чтобы вызвать accounts.list. Затем найдите в списке идентификатор того аккаунта, в который вы хотите перенести адрес. В качестве идентификатора аккаунта можно использовать идентификатор администратора, полученный во время первого шага в ответ на вызов account.admins.create или accounts.invitations.list. Это идентификатор может быть связан как с личным аккаунтом, так и с группой адресов.

3. Используйте идентификатор аккаунта, полученный на шаге 2, в качестве целевого. Он находится в поле destinationAccount в теле запроса и необходим для вызова locations.transfer.

   Примечание. После завершения переноса целевой аккаунт будет основным аккаунтом, связанным с владельцем данных о компании. Если это не тот результат, которого вы хотели, повторите шаги 1-3 для другого пользователя. Затем перенесите адрес обратно в исходный основной аккаунт. Вы также можете использовать конечную точку accounts.admins.patch, чтобы вернуть права администратора исходному целевому аккаунту.

Используйте учетные данные OAuth целевого аккаунта, чтобы вызвать accounts.locations.list, и убедитесь, что перенесенный адрес показывается в результатах. При вызове конечной точки accounts.locations.list с использованием исходного аккаунта перенесенный адрес не включается в результаты.

Перенос в группу адресов

Чтобы перенести адрес в location group в организации, вызовите locations.admins.create с использованием учетных данных OAuth merchant. Используйте поле account в ресурсе Admin для передачи location group account ID с соответствующим role. Используйте учетные данные администратора location group для вызова accounts.invitations.list с идентификатором аккаунта группы адресов в качестве аргумента parent, чтобы получить приглашения, относящиеся к location group. Найдите приглашение с правильным целевым адресом, а затем вызовите accounts.invitations.accept, чтобы принять его.