Mentransfer lokasi

Dengan My Business Account Management API, Anda dapat mentransfer lokasi ke akun atau grup lokasi yang berbeda-beda. Ikuti petunjuk dalam dokumentasi ini untuk mempelajari caranya.

Mulai

Item berikut diperlukan untuk mentransfer lokasi:

Akun sumber: Akun sumber adalah akun yang merupakan pemilik lokasi. Akun ini dapat berupa akun pribadi atau grup lokasi. Setelah transfer selesai, akun sumber tidak lagi memiliki akses ke lokasi.
Akun tujuan: Akun tujuan adalah akun tempat lokasi akan ditransfer. Akun ini dapat berupa akun pribadi atau grup lokasi. Setelah transfer selesai, akun tujuan adalah pemilik utama lokasi.
Token refresh/akses OAuth2: Token refresh/akses OAuth2 untuk akun sumber dan tujuan diperlukan untuk setiap akun agar dapat memanggil API.

Mentransfer Lokasi

Untuk mentransfer lokasi, selesaikan langkah berikut:

  1. Jika Anda bukan pemilik lokasi, Anda harus menjadi pemiliknya. Gunakan kredensial OAuth pemilik bisnis saat ini untuk memanggil account.admins.create dan mengundang pengguna untuk memiliki listingan. Selanjutnya, gunakan kredensial OAuth pengguna yang diundang untuk memanggil accounts.invitations.list dan mendapatkan ID undangan. Panggil accounts.invitations.accept untuk menyetujui undangan ini.

  2. Gunakan kredensial OAuth akun tujuan yang dimaksud untuk memanggil accounts.list. Selanjutnya, temukan ID akun dalam daftar tempat Anda akan mentransfer lokasi. ID admin sebagai respons terhadap panggilan account.admins.create atau panggilan accounts.invitations.list pada langkah 1 juga dapat digunakan sebagai ID akun. ID akun ini dapat merujuk pada akun pribadi atau grup lokasi.

  3. Gunakan ID akun yang Anda ambil pada langkah 2 sebagai akun tujuan. Ini adalah kolom destinationAccount dalam isi permintaan, yang dapat Anda gunakan untuk memanggil locations.transfer.

Gunakan kredensial OAuth akun tujuan untuk memanggil accounts.locations.list dan memverifikasi apakah lokasi yang ditransfer muncul dalam hasil. Jika Anda memanggil endpoint accounts.locations.list dengan akun sumber, lokasi yang ditransfer tidak akan disertakan dalam hasil.

Mentransfer ke grup lokasi

Untuk mentransfer lokasi ke location group di organisasi, panggil locations.admins.create menggunakan kredensial OAuth merchant. Gunakan kolom account di resource Admin untuk meneruskan location group account ID bersama dengan role yang sesuai. Anda harus menggunakan kredensial admin location group untuk memanggil accounts.invitations.list menggunakan ID akun grup lokasi sebagai argumen parent untuk mengambil undangan yang terkait dengan location group. Temukan undangan yang memiliki lokasi target yang benar, lalu panggil accounts.invitations.accept untuk menerima undangan yang tepat.