GoogleLocations

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

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

На следующем изображении представлен обзор процесса получения права собственности на местоположение.

Рис. 1. Диаграмма Swimlane для владельцев местоположений бизнес-профиля

Следующие шаги позволяют использовать API GoogleLocations :

  1. Соберите данные о местоположении у продавца.

  2. Вызовите конечную точку googleLocations.search . Предоставьте данные о местоположении в теле вызова. Кроме того, вы можете указать его в строке запроса, аналогично тому, что пользователь вводит в поиске или на картах. Например, «Старбакс, 5-я авеню, Нью-Йорк».

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

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

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

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