Bekerja dengan 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 tentang 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. Gunakan accounts.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 tertentu untuk pengguna terautentikasi. Gunakan accounts.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 mendasar. Gunakan accounts.update API untuk mengubah nama akun.

Untuk memperbarui akun tertentu 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. Kolom lain yang diteruskan akan diabaikan.
  • Hanya akun jenis BUSINESS yang dapat diperbarui dengan cara ini.