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.

Catatan: Untuk mentransfer lokasi, pemanggil harus menjadi pemilik lokasi dan pemegang akun tujuan setidaknya harus menjadi pengelola lokasi. Untuk mendapatkan detail tentang cara memberikan kepemilikan listingan, lihat Mengelola admin untuk akun dan lokasi.

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

Catatan: Admin lokasi di Profil Bisnis akan melalui masa percobaan. Setelah pengguna ditambahkan ke profil sebagai pemilik atau pengelola, tindakan yang dapat pengguna tersebut lakukan terhadap pengguna lokasi lain dan lokasi itu sendiri akan dibatasi selama 7 hari. Selama periode ini, pengguna dalam masa percobaan tidak akan dapat mentransfer kepemilikan utama profil kepada dirinya sendiri atau pengguna ketiga.

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.

   Catatan: Penerima tidak boleh merupakan anggota akun organisasi atau grup pengguna.

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.

   Catatan: Setelah transfer selesai, akun tujuan adalah akun utama yang terkait dengan pemilik listingan. Jika ini bukan hasil yang diinginkan, ulangi langkah 1-3 dengan pengguna baru. Selanjutnya, transfer lokasi kembali ke akun utama aslinya. Anda dapat menggunakan endpoint accounts.admins.patch untuk mendowngrade peran admin akun tujuan asli.

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.