GoogleLocations API позволяет заранее узнать, заявлял ли кто-то права собственности на определенный адрес в сервисе "Профиль компании". Если у адреса есть владелец, вы можете сразу же запросить доступ к данным. Если вы управляете аккаунтами с массовым подтверждением, вы можете заранее и с большей точностью выявить подходящие адреса, а также избежать повторов.
Конечная точка API возвращает URL, который указывает, были ли уже запрошены права на определенный адрес. Если да, то этот же URL можно использовать для запроса доступа.
На схеме ниже показано, как устроен процесс получения права собственности.
![](https://developers.google.cn/static/my-business/images/locations1.png?authuser=8&hl=ru)
Для использования GoogleLocations
API необходимо выполнить следующие действия:
- Получите от продавца данные об адресе.
-
Вызовите конечную точку
googleLocations.search
. Укажите данные об адресе в теле вызова. Кроме того, вы можете воспользоваться строкой запроса, как в Google Поиске или Картах. Пример: "Старбакс Арбат Москва".API возвращает список возможных мест с информацией о них, такой как
locationName
и адрес. - Выберите место, соответствующее вашему адресу. Если подходящих вариантов нет, вызовите
accounts.locations.create
и перейдите к шагу 5. -
В зависимости от статуса
requestAdminRightsUrl
в ответе выполните следующие действия:- Если
requestAdminRightsUrl
существует, право собственности на данные о компании уже предоставлено другому пользователю. Попросите продавца перейти по указанному URL, чтобы запросить доступ и права. - Если
requestAdminRightsUrl
отсутствует, вызовитеaccounts.locations.create
и создайте новые данные о компании, которые необходимо будет впоследствии подтвердить.
- Если
- Если в ходе процесса вы создали новые данные, воспользуйтесь API для их подтверждения. Подробнее…