Mengelola lokasi dalam skala besar

Seiring dengan berkembangnya organisasi Anda, pengelolaan lokasi dan izin Anda dapat membebani Anda. Panduan ini menjelaskan praktik terbaik untuk mengelola beberapa lokasi, dan menjelaskan jenis akun berikut:

Jenis akun

Setiap jenis akun memiliki peran dalam pengelolaan lokasi. Akun pribadi dapat mengelola akun organisasi, lalu mendapatkan izin ke grup pengguna dan grup lokasi di organisasi tersebut. Akun pribadi lalu dapat mengelola lokasi dan listingan melalui grup lokasi yang terkait.

Akun pribadi

Akun pribadi akan otomatis tersedia untuk Anda saat Anda membuat Akun Google. Akun pribadi bisa merupakan pemilik dan pengelola listingan.

Akun organisasi

Akun organisasi adalah akun lapisan teratas yang mewakili agensi Anda. Grup lokasi dan grup pengguna Anda disimpan di dalamnya, dan semua anggota organisasi memiliki akses ke grup tersebut. Lokasi dapat menjadi bagian dari beberapa organisasi.

Dengan My Business Account Management API, Anda dapat menggunakan metode accounts.admins.create dalam mengundang akun pribadi untuk mengelola atau menjadi pemilik akun organisasi.

Akun grup lokasi

Grup lokasi digunakan untuk mengelola kelompok lokasi individual. Anda dapat menggunakan grup lokasi untuk melakukan tugas massal ke beberapa lokasi. Saat Anda menambahkan akun pribadi dan grup pengguna ke grup lokasi, izin grup lokasi akan diwariskan.

Anda juga dapat membuat grup lokasi untuk mengategorikan lokasi, seperti menurut jaringan gerai, wilayah, atau kategori. Lokasi dapat berada di beberapa grup lokasi sekaligus.

Dengan My Business Account Management API, Anda dapat menggunakan metode accounts.create untuk membuat grup lokasi, dan mentransfer lokasi ke grup lokasi. Anda juga dapat mengundang akun pribadi untuk mengelola grup lokasi dengan API. Grup pengguna dapat langsung ditambahkan ke grup lokasi dari antarmuka web.

Akun grup pengguna

Untuk mengelola izin dengan skala lebih besar, gunakan grup pengguna. Anda dapat menambahkan akun pribadi ke grup pengguna. Kemudian, Anda dapat memberikan akses pengelolaan grup pengguna ke beberapa grup lokasi di organisasi. Sekarang semua akun pribadi dalam grup pengguna dapat melakukan tindakan pengelolaan pada lokasi dalam grup lokasi.

Misalnya, saat anggota baru bergabung dengan tim operasi, Anda dapat menambahkannya langsung ke grup pengguna dan mereka langsung mendapatkan akses ke semua lokasi yang aksesnya dimiliki oleh rekan sejawat mereka. Jika Anda memberi pengguna akses ke setiap lokasi, prosesnya akan perlu waktu lebih lama dan lebih sulit untuk mengelolanya.

Dengan My Business Account Management API, Anda dapat menggunakan metode accounts.create untuk membuat grup pengguna. Anda juga dapat menggunakan API ini untuk mengundang akun pribadi agar dapat mengelola admin untuk akun dan lokasi.

Menggunakan API untuk memanggil daftar semua akun

Untuk menampilkan daftar semua akun yang aksesnya Anda miliki, dan jenis akun terkait, panggil metode accounts.list dengan kredensial OAuth. Respons berisi daftar semua akun, ID akunnya, yang ada di kolom nama, dan jenis akun.

Permintaan

Berikut adalah contoh permintaan accounts.list:

HTTP
GET
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Authorization: Bearer <access_token>

Respons

Berikut adalah contoh respons accounts.list:

{
    "accounts": [
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe",
            "type": "PERSONAL",
            "state": {
                "status": "UNVERIFIED"
            },
            "profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED"
        },
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe’s Location Group",
            "type": "LOCATION_GROUP",
            "role": "OWNER",
            "state": {
                "status": "UNVERIFIED"
            },
            "accountNumber": "{accountNumber}",
            "permissionLevel": "OWNER_LEVEL"
        }
    ]
}

Semua jenis akun yang diuraikan dalam panduan ini mungkin akan disertakan dalam respons untuk permintaan accounts.list Anda. Tinjau daftar akun dan identifikasi akun spesifik yang memiliki akses ke lokasi yang ingin Anda kelola. Selanjutnya, panggil accounts.locations.list dengan kolom nama untuk akun spesifik agar dapat mengambil daftar lokasi yang aksesnya dimiliki akun.

Misalnya, jika Anda ingin mengambil semua lokasi yang termasuk dalam "Grup Lokasi Seseorang", buat permintaan berikut:

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>

Respons akan menampilkan daftar lokasi yang aksesnya dimiliki pengguna, sebagai berikut:

{
    "locations": [
        {
            "name": "locations/{locationId}",
            "locationName": "Test Business",
            ...
        },
        {
            "name": "locations/{locationId}",
            "locationName": "2nd Test Business",
            ...
         }
     ]
}

Diagram pengelolaan lokasi

Diagram berikut menggambarkan informasi berikut:

  • Organisasi dapat berisi beberapa grup pengguna.
  • Grup pengguna dapat mengelola beberapa grup lokasi.
  • Grup lokasi dapat berisi beberapa lokasi.
  • Lokasi dapat mencakup beberapa grup lokasi di seluruh organisasi.
Hierarki pengelolaan lokasi
Gambar 1. Hierarki pengelolaan lokasi