Perhatian: Postingan yang terkait dengan COVID-19 sekarang diizinkan sementara untuk jaringan gerai. Selain itu, Google Bisnisku saat ini beroperasi dengan fungsi terbatas. Pelajari perubahan produk sementara lebih lanjut.

Mengelola lokasi sesuai skala

Seiring dengan berkembangnya organisasi Anda, pengelolaan lokasi dan izin Anda dapat membebani Anda. Panduan ini menjelaskan praktik terbaik untuk mengelola beberapa lokasi, dan mendeskripsikan 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 otomatis tersedia untuk Anda saat membuat Akun Google. Akun pribadi dapat menjadi 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 API, Anda dapat menggunakan metode accounts.admins.create untuk mengundang akun pribadi untuk mengelola atau memiliki akun organisasi.

Akun grup lokasi

Grup lokasi digunakan untuk mengelola grup 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 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 pada skala 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. Memberi pengguna akses ke setiap lokasi individual akan memerlukan waktu lebih lama dan lebih sulit untuk mengelolanya.

Dengan API, Anda dapat menggunakan metode accounts.create untuk membuat grup pengguna. Anda juga dapat menggunakan API untuk mengundang akun pribadi untuk 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://mybusiness.googleapis.com/v4/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://mybusiness.googleapis.com/v4/accounts/{accountId}/locations
Authorization: Bearer <access_token>

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

{
    "locations": [
        {
            "name": "accounts/{accountId}/locations/{locationId}",
            "locationName": "Test Business",
            ...
        },
        {
            "name": "accounts/{accountId}/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