Memigrasikan pengelolaan akun

Accounts API dibagi menjadi kumpulan resource untuk memungkinkan pengelolaan akun Merchant Center Anda secara lebih efisien dengan kontrol yang lebih presisi di berbagai aspek akun Anda.

Panduan ini menjelaskan perubahan utama dan membantu Anda memigrasikan integrasi pengelolaan akun yang ada dari Content API for Shopping ke Merchant API.

Dari satu resource ke banyak resource

Di Content API for Shopping, resource Account adalah objek monolitik yang berisi semuanya, mulai dari nama akun dan URL situs hingga daftar pengguna dan informasi bisnis.

Merchant API membagi ini menjadi beberapa resource yang lebih kecil dan lebih terfokus. Perubahan ini memungkinkan panggilan API yang lebih tertarget dan efisien. Misalnya, untuk memperbarui hanya alamat bisnis, Anda kini membuat permintaan PATCH ke resource BusinessInfo daripada memperbarui seluruh objek Account.

Berikut ringkasan cara konsep dari referensi Content API for Shopping Account dipetakan ke referensi baru di Merchant API:

Kemampuan baru

Merchant API juga memperkenalkan kemampuan baru untuk pengelolaan akun yang tidak tersedia di Content API for Shopping:

  • Persyaratan Layanan: Ambil dan setujui Persyaratan Layanan secara terprogram menggunakan resource TermsOfService dan TermsOfServiceAgreementState.
  • Akses Akun dengan Alias: Akses akun menggunakan format providerId~accountAlias, yang memberikan cara yang konsisten bagi bisnis yang mengelola beberapa akun untuk menggunakan ID akun mereka sendiri.

Permintaan

Tabel ini memberikan perbandingan gabungan URL permintaan untuk tugas pengelolaan akun umum antara Content API for Shopping dan Merchant API.

Deskripsi permintaan Content API for Shopping Merchant API
Mendapatkan akun GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Mendapatkan akun berdasarkan alias Tidak tersedia secara langsung GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
Mencantumkan sub-akun GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
Buat sub-akun POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
Memperbarui data akun PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} PATCH pada resource yang sesuai. Misalnya, untuk memperbarui nama akun: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Menghapus sub-akun DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Mengklaim situs POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
Tautkan akun POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

Mengelola informasi akun inti

Resource Account di Merchant API berisi detail penting akun Merchant Center, seperti nama, ID, dan setelan dasarnya.

Perbandingan permintaan

Deskripsi permintaan Content API for Shopping Merchant API
Mendapatkan detail akun GET /content/v2.1/{merchantId}/accounts/{accountId} (mengakses atribut inti seperti name, adult_content) GET /accounts/v1/accounts/{account}
Membuat sub-akun POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
Memperbarui detail akun PUT /content/v2.1/{merchantId}/accounts/{accountId} (memperbarui atribut inti) PATCH /accounts/v1/accounts/{account}
Menghapus sub-akun DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

Perbandingan kolom mendetail

Content API for Shopping (Account) Merchant API (Account) Catatan
id account_id ID numerik sekarang menjadi kolom hanya output. ID utama adalah resource name.
name account_name Nama akun yang dapat dibaca pengguna.
language language_code Nama kolom sekarang adalah language_code.

Mengelola informasi bisnis

Gunakan resource BusinessInfo untuk mengelola informasi publik tentang bisnis Anda, seperti alamat dan kontak layanan pelanggan. Tindakan ini menggantikan objek businessInformation di Content API for Shopping.

Perbandingan permintaan

Deskripsi permintaan Content API for Shopping Merchant API
Mendapatkan informasi bisnis GET /content/v2.1/{merchantId}/accounts/{accountId} (mengakses atribut business_information) GET /accounts/v1/accounts/{account}/businessInfo
Memperbarui informasi bisnis PUT /content/v2.1/{merchantId}/accounts/{accountId} (memperbarui atribut business_information) PATCH /accounts/v1/accounts/{account}/businessInfo

Perbandingan kolom mendetail

Content API for Shopping (business_information) Merchant API (BusinessInfo) Catatan
phone_number phone Kolom ini sekarang adalah phone dan menggunakan google.type.PhoneNumber.
customer_service.url customer_service.uri Nama kolom sekarang adalah uri.

Mengelola halaman beranda Anda

Untuk mengelola URL situs toko Anda serta melakukan verifikasi dan klaim, gunakan resource Homepage. Ini menggantikan kolom websiteUrl dan metode accounts.claimwebsite dari Content API for Shopping.

Perbandingan permintaan

Deskripsi permintaan Content API for Shopping Merchant API
Mendapatkan URL halaman beranda GET /content/v2.1/{merchantId}/accounts/{accountId} (mengakses atribut website_url) GET /accounts/v1/accounts/{account}/homepage
Memperbarui URL halaman beranda PUT /content/v2.1/{merchantId}/accounts/{accountId} (memperbarui atribut website_url) PATCH /accounts/v1/accounts/{account}/homepage
Klaim halaman beranda POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
Membatalkan klaim halaman beranda Tidak tersedia POST /accounts/v1/accounts/{account}/homepage:unclaim

Perbandingan kolom mendetail

Content API for Shopping (Account) Merchant API (Homepage) Catatan
website_url uri URL halaman beranda toko.
Tidak tersedia secara langsung claimed Kolom boolean yang bernilai true jika halaman beranda diklaim.

Kelola pengguna

Resource User memungkinkan Anda mengelola siapa yang dapat mengakses akun Merchant Center. Tindakan ini akan menggantikan array users dalam resource Account. Perbedaan utamanya adalah proses pembuatan pengguna. Di Merchant API, menambahkan pengguna akan mengirimkan undangan. Pengguna harus menerima undangan sebelum dapat mengakses akun.

Perbandingan permintaan

Deskripsi permintaan Content API for Shopping Merchant API
Mencantumkan pengguna GET /content/v2.1/{merchantId}/accounts/{accountId} (mengakses atribut users) GET /accounts/v1/accounts/{account}/users
Membuat pengguna PUT /content/v2.1/{merchantId}/accounts/{accountId} (memperbarui atribut users) POST /accounts/v1/accounts/{account}/users
Memperbarui pengguna PUT /content/v2.1/{merchantId}/accounts/{accountId} (memperbarui atribut users) PATCH /accounts/v1/accounts/{account}/users/{email}
Hapus pengguna PUT /content/v2.1/{merchantId}/accounts/{accountId} (memperbarui atribut users) DELETE /accounts/v1/accounts/{account}/users/{email}

Perbandingan kolom mendetail

Content API for Shopping (objek array users) Merchant API (resource User) Catatan
email_address name (dalam format accounts/{account}/users/{email}) Email pengguna kini menjadi bagian dari nama resource.
admin, order_manager, reporting_manager, dll. access_rights Hak akses kini digabungkan ke dalam kolom enum berulang.
Tidak tersedia state Kolom hanya output baru yang menunjukkan apakah pengguna adalah PENDING atau VERIFIED.

Mengelola hubungan dan layanan akun

Di Content API for Shopping, hubungan dikelola dengan accounts.link. Merchant API memperkenalkan model yang lebih eksplisit dengan resource AccountService dan AccountRelationship, yang memerlukan proses handshake (mengajukan dan menyetujui).

Perbandingan permintaan

Deskripsi permintaan Content API for Shopping Merchant API
Tautkan akun POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
Mencantumkan akun tertaut GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships dan GET /accounts/v1/accounts/{account}/services

Perbandingan kolom mendetail

Content API for Shopping (AccountLink) Merchant API (AccountService, AccountRelationship) Catatan
linked_account_id provider (dalam AccountService) ID akun yang menyediakan layanan.
service service_type (dalam AccountService) Jenis layanan yang diberikan (misalnya, ACCOUNT_AGGREGATION).
status handshake.approval_state (dalam AccountService) Status link (misalnya, PENDING, ESTABLISHED).

Setelan pajak akun

Layanan accounttax dari Content API for Shopping tidak tersedia di Merchant API. Pajak penjualan Amerika Serikat tidak lagi wajib dicantumkan. Untuk mengetahui informasi selengkapnya, lihat Pembaruan spesifikasi data produk Merchant Center 2025.

Mengelola identitas bisnis

Gunakan resource BusinessIdentity untuk menyatakan sendiri atribut tentang bisnis Anda. Ini menggantikan objek businessIdentity di Content API for Shopping.

Perbandingan permintaan

Deskripsi permintaan Content API for Shopping Merchant API
Mendapatkan identitas bisnis GET /content/v2.1/{merchantId}/accounts/{accountId} (mengakses atribut business_identity) GET /accounts/v1/accounts/{account}/businessIdentity
Memperbarui identitas bisnis PUT /content/v2.1/{merchantId}/accounts/{accountId} (memperbarui atribut business_identity) PATCH /accounts/v1/accounts/{account}/businessIdentity

Perbandingan kolom mendetail

Content API for Shopping (business_identity) Merchant API (BusinessIdentity) Catatan
black_owned.self_identified (boolean) black_owned.identity_declaration (enum) Boolean diganti dengan enum (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) untuk deklarasi yang lebih eksplisit. Hal ini berlaku untuk semua atribut identitas.
include_for_promotions (boolean) promotions_consent (enum) Boolean global digantikan oleh enum yang lebih deskriptif (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED).

Mencantumkan akun

Di Content API for Shopping, satu-satunya jenis akun tingkat lanjut adalah 'Akun Multiklien (MCA)' dan akun ini mengekspos metode accounts.list untuk mencantumkan sub-akun dari Akun Multiklien tertentu. Akun lanjutan di Merchant API jauh lebih canggih, sehingga memungkinkan berbagai jenis dan hubungan akun yang lebih luas. Untuk memungkinkan migrasi yang mudah bagi akun lanjutan, Merchant API menyediakan padanan langsung untuk accounts.list Content API for Shopping sebagai metode accounts.listSubaccounts. Kami memperkenalkan metode accounts.list baru yang lebih canggih yang memungkinkan pemfilteran akun lanjutan.

Perbandingan permintaan

Deskripsi permintaan Content API for Shopping Merchant API
Mencantumkan sub-akun GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
Mencantumkan semua akun yang dapat diakses Tidak tersedia GET /accounts/v1/accounts

Perbandingan kolom mendetail (Parameter permintaan)

Content API for Shopping (accounts.list) Merchant API (accounts.listSubaccounts) Catatan
merchant_id (parameter jalur) provider (parameter jalur) ID akun tingkat lanjut dalam format accounts/{account}.
max_results page_size Jumlah maksimum akun yang akan ditampilkan.