Memigrasikan penautan akun

Pengelolaan hubungan akun telah berkembang dari satu metode link di Content API for Shopping menjadi sistem yang lebih terperinci dan eksplisit di Merchant API. API baru ini menggunakan resource khusus seperti AccountRelationship dan AccountService untuk menentukan layanan tertentu yang disediakan satu akun ke akun lainnya. Untuk mengetahui detail selengkapnya, lihat Hubungan antar-akun.

Perbedaan utama

  • Resource khusus untuk hubungan dan layanan: Di Merchant API, resource AccountRelationship menentukan koneksi antara penyedia layanan dan penjual, sedangkan resource AccountService menentukan layanan persis yang disediakan (misalnya accountAggregation). Hal ini menggantikan kolom linkType dan services generik dari Content API for Shopping.
  • Metode tindakan eksplisit: Daripada satu metode link dengan parameter action, Merchant API menggunakan metode yang berbeda untuk mengelola layanan, seperti propose, approve, dan reject.
  • Penautan Google Profil Bisnis khusus: Penautan ke Google Profil Bisnis, yang sebelumnya ditangani dengan menetapkan kolom googleMyBusinessLink kini memiliki metode khusus, gbpAccounts.linkGbpAccount.
  • Pembuatan akun klien sebagai layanan: Pembuatan akun klien di bawah akun lanjutan kini diperlakukan sebagai pengajuan layanan accountAggregation menggunakan metode accounts.createAndConfigure. Informasi selengkapnya tentang akun tersedia di halaman Merchant Accounts API. Tidak diperlukan handshake, karena pengguna memiliki akses ke akun lanjutan dan akun klien.

Permintaan

Merchant API menyediakan endpoint khusus untuk mengelola berbagai jenis link dan layanan akun:

URL permintaan Merchant API

  • Mengajukan layanan baru: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Menyetujui layanan: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Menolak layanan: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Menautkan ke Google Profil Bisnis: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Membuat akun klien (link agregasi akun): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

Perbandingan URL permintaan

Deskripsi permintaan Content API for Shopping Merchant API
Menautkan akun (misalnya, platform pihak ketiga) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Menautkan ke Google Profil Bisnis PUT .../v2.1/{merchantId}/accounts/{accountId} (dengan kolom googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
Membuat akun klien POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Metode

Metode Content API for Shopping Metode Merchant API Ketersediaan &catatan
accounts.link accountServices.propose Gunakan metode ini untuk memulai layanan baru dengan akun lain.
accounts.link (dengan action: "approve") accountServices.approve Gunakan metode ini untuk menyetujui proposal layanan yang tertunda.
accounts.link (dengan action: "remove") accountServices.reject Gunakan metode ini untuk menolak layanan yang tertunda atau yang sudah dibuat.
accounts.insert (untuk akun klien) accounts.createAndConfigure Gunakan metode ini dengan layanan accountAggregation untuk membuat akun klien baru di bawah akun lanjutan.
accounts.update (dengan googleMyBusinessLink) gbpAccounts.linkGbpAccount Gunakan metode khusus ini untuk menautkan akun Merchant Center ke Google Profil Bisnis.
accounts.update (dengan adsLinks) Resource AccountRelationship Penautan ke Google Ads dikelola dari UI Google Ads. Link yang dihasilkan ditampilkan sebagai AccountRelationship di Merchant API, yang dapat dilihat, tetapi tidak dapat dibuat secara langsung.

Perubahan kolom mendetail

Content API for Shopping Merchant API Deskripsi
AccountsLinkRequest.action Metode propose, approve, reject Satu kolom action diganti dengan metode API khusus untuk setiap perubahan status dalam siklus proses layanan.
AccountsLinkRequest.linkType AccountService.service_type String linkType generik diganti dengan kolom oneof service_type terstruktur dalam resource AccountService, seperti productsManagement atau accountAggregation
AccountsLinkRequest.services AccountService.service_type Daftar layanan berbasis string kini ditampilkan oleh service_type tertentu yang dipilih dalam resource AccountService.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider ID akun yang menyediakan layanan kini ditentukan di kolom provider permintaan propose.
Account.googleMyBusinessLink LinkGbpAccountRequest Objek yang berisi detail link GBP diganti dengan pesan permintaan khusus untuk metode linkGbpAccount.
Account.adsLinks AccountRelationship Link Google Ads ditampilkan sebagai AccountRelationship dengan provider adalah providers/GOOGLE_ADS. Hubungan ini biasanya dikelola dari UI Google Ads.