GoogleLocations

GoogleLocations API позволяет заранее узнать, заявлял ли кто-то права собственности на определенный адрес в сервисе "Профиль компании". Если у адреса есть владелец, вы можете сразу же запросить доступ к данным. Если вы управляете аккаунтами с массовым подтверждением, вы можете заранее и с большей точностью выявить подходящие адреса, а также избежать повторов.

Конечная точка API возвращает URL, который указывает, были ли уже запрошены права на определенный адрес. Если да, то этот же URL можно использовать для запроса доступа.

На схеме ниже показано, как устроен процесс получения права собственности.

Рисунок 1. Процесс получения права собственности на адрес в сервисе "Профиль компании".

Для использования GoogleLocations API необходимо выполнить следующие действия:

  1. Получите от продавца данные об адресе.

  2. Вызовите конечную точку googleLocations.search. Укажите данные об адресе в теле вызова. Кроме того, вы можете воспользоваться строкой запроса, как в Google Поиске или Картах. Пример: "Старбакс Арбат Москва".

    API возвращает список возможных мест с информацией о них, такой как locationName и адрес.

  3. Выберите место, соответствующее вашему адресу. Если подходящих вариантов нет, вызовите accounts.locations.create и перейдите к шагу 5.

  4. В зависимости от статуса requestAdminRightsUrl в ответе выполните следующие действия:

    1. Если requestAdminRightsUrl существует, право собственности на данные о компании уже предоставлено другому пользователю. Попросите продавца перейти по указанному URL, чтобы запросить доступ и права.
    2. Если requestAdminRightsUrl отсутствует, вызовите accounts.locations.create и создайте новые данные о компании, которые необходимо будет впоследствии подтвердить.
  5. Если в ходе процесса вы создали новые данные, воспользуйтесь API для их подтверждения. Подробнее…