GoogleLocations

GoogleLocations API memungkinkan Anda melihat di awal apakah lokasi sebelumnya telah diklaim di Profil Bisnis. Dengan demikian, jika lokasi telah diklaim, Anda dapat segera meminta akses ke lokasi. Selain itu, jika mengelola akun terverifikasi massal, Anda dapat lebih akurat memilih potensi kecocokan di awal dan menghindari pembuatan lokasi duplikat.

Endpoint API menampilkan URL yang menunjukkan apakah suatu lokasi telah diklaim. Jika lokasi telah diklaim, URL yang sama memungkinkan Anda memulai proses permintaan akses.

Gambar berikut memberikan ringkasan proses untuk mendapatkan kepemilikan lokasi.

Gambar 1. Diagram swimlane kepemilikan lokasi Profil Bisnis

Langkah berikut memungkinkan Anda menggunakan GoogleLocations API:

  1. Kumpulkan data lokasi dari penjual.
  2. Panggil endpoint googleLocations.search. Masukkan data lokasi dalam isi panggilan. Atau, Anda dapat menyediakannya dalam string kueri, mirip dengan yang dimasukkan di Penelusuran atau Maps. Misalnya, "Starbucks 5th ave NYC."

    API ini menampilkan daftar lokasi yang berpotensi cocok dan informasi tentang setiap lokasi, seperti locationName dan alamat.

  3. Pilih lokasi yang cocok dengan lokasi Anda. Jika tidak ada kecocokan, panggil accounts.locations.create, dan lanjutkan ke langkah 5.
  4. Berdasarkan status requestAdminRightsUrl dalam respons, lakukan tindakan berikut:

    1. Jika requestAdminRightsUrl ada, berarti pengguna lain memiliki kepemilikan listingan. Arahkan penjual ke URL untuk memulai permintaan akses dan kepemilikan lokasi yang ada di Profil Bisnis.
    2. Jika requestAdminRightsUrl tidak ada, panggil accounts.locations.create dan buat listingan baru yang akan diverifikasi nanti.
  5. Jika membuat listingan baru sebagai bagian dari proses ini, Anda dapat menggunakan API verifikasi untuk memulai verifikasi listingan. Untuk mendapatkan informasi lebih lanjut, lihat Mengelola verifikasi.