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.
  • Perbarui akun.

Sebelum memulai

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

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

Menampilkan daftar semua akun

Cara yang bagus untuk memvalidasi akun yang terkait dengan pengguna terautentikasi adalah dengan menampilkan daftar semua akun mereka. Menggunakan 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 yang diotentikasi. Menggunakan 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 yang akan diubah 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"
}

Pembatasan

  • Satu-satunya kolom yang dapat diedit untuk akun adalah accountName. Kolom lainnya yang lewat akan diabaikan.
  • Hanya akun jenis BUSINESS yang dapat diperbarui dengan cara ini.