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 spesifik yang disediakan satu akun untuk akun lain. Untuk mengetahui detail selengkapnya, lihat Hubungan antar-akun.

Perbedaan utama

  • Resource khusus untuk hubungan dan layanan: Di Merchant API, resource AccountRelationship menentukan hubungan 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 menggunakan 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 akun lanjutan kini diperlakukan sebagai pengajuan layanan accountAggregation menggunakan metode accounts.createAndConfigure. Informasi selengkapnya tentang akun tersedia di halaman Merchant Accounts API. Tidak perlu verifikasi, karena pengguna memiliki akses ke akun lanjutan dan akun klien.

Permintaan

Merchant API menyediakan endpoint tertentu untuk mengelola berbagai jenis penautan dan layanan akun:

URL permintaan Merchant API

  • Mengusulkan 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

Meminta perbandingan URL

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 sudah dibuat.
accounts.insert (untuk akun klien) accounts.createAndConfigure Gunakan metode ini dengan layanan accountAggregation untuk membuat akun klien baru di 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 propose, approve, reject metode Kolom action tunggal digantikan 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 diwakili 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 digantikan oleh pesan permintaan khusus untuk metode linkGbpAccount.
Account.adsLinks AccountRelationship Link Google Ads ditampilkan sebagai resource AccountRelationship dengan provider adalah providers/GOOGLE_ADS. Hubungan ini biasanya dikelola dari UI Google Ads.