Menggunakan data akun

Tutorial ini menunjukkan kepada Anda cara menggunakan data akun. My Business Account Management API memberi Anda kemampuan untuk melakukan hal berikut:

  • Menampilkan daftar semua akun.
  • Menampilkan akun spesifik.
  • Memperbarui akun.

Sebelum memulai

Sebelum menggunakan My Business Account Management API, Anda harus mendaftarkan aplikasi Anda dan mendapatkan kredensial OAuth 2.0.

Untuk mengetahui detail cara mulai menggunakan API Profil Bisnis, lihat Penyiapan dasar.

Menampilkan daftar semua akun

Cara terbaik untuk memvalidasi akun yang terkait dengan pengguna terautentikasi adalah menampilkan daftar semua akun mereka. Gunakanaccounts.list API untuk menampilkan daftar semua akun yang terkait dengan pengguna.

Untuk menampilkan daftar semua akun untuk pengguna terautentikasi, gunakan hal berikut:

HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

Menampilkan akun spesifik

Terkadang, Anda hanya ingin melihat informasi tentang akun spesifik untuk pengguna terautentikasi. Gunakanaccounts.get API untuk menampilkan akun spesifik dan meninjau detail akun tambahan.

Untuk menampilkan akun spesifik berdasarkan nama, gunakan hal berikut:

HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

Memperbarui akun

Mengubah nama akun adalah tugas administratif dasar. Gunakan accounts.update API untuk mengubah nama akun.

Untuk memperbarui akun spesifik berdasarkan nama, gunakan hal berikut:

HTTP
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

{
  "account": {
    "accountName": "Anne Droyd"
  },
  "languageCode": "en",
  "validateOnly": "true"
}

Batasan

  • Satu-satunya kolom yang dapat diedit untuk akun adalah accountName. Setiap kolom lain yang diteruskan akan diabaikan.
  • Hanya akun jenis BUSINESS yang dapat diperbarui dengan cara ini.