Memigrasikan pengelolaan akun

Accounts API dibagi menjadi kumpulan resource untuk memungkinkan pengelolaan akun Merchant Center Anda secara lebih efisien dengan kontrol yang lebih akurat 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 membaginya menjadi beberapa resource yang lebih kecil dan lebih fokus. Perubahan ini memungkinkan panggilan API yang lebih bertarget dan efisien. Misalnya, untuk memperbarui alamat bisnis saja, Anda kini membuat permintaan PATCH ke resource BusinessInfo, bukan memperbarui seluruh objek Account.

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

• Detail akun inti (ID, nama, setelan konten khusus dewasa) tetap berada di resource Account.
• Informasi bisnis (alamat, nomor telepon, layanan pelanggan) kini dikelola oleh resource BusinessInfo.
• URL situs dan klaim ditangani oleh resource Homepage.
• Pengelolaan pengguna ditangani oleh resource User.
• Hubungan akun (link ke akun tingkat lanjut, penyedia pihak ketiga, dan layanan Google lainnya) dikelola oleh resource AccountRelationship dan AccountService.
• Atribut identitas bisnis (misalnya, milik orang kulit hitam, milik perempuan) dikelola oleh resource BusinessIdentity.
• Perjanjian Persyaratan Layanan (ToS), yang merupakan fitur baru, dikelola oleh resource TermsOfService dan TermsOfServiceAgreementState.

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.
• Pembuatan akun: Metode accounts.createAndConfigure kini mendukung pembuatan akun dengan hubungan (seperti accountManagement), menetapkan alias, dan menyembunyikan verifikasi email menggunakan kolom user.verificationMailSettings.verificationMailMode untuk mendukung verifikasi berbasis API menggunakan metode accounts.verifySelf baru.
• Akses Akun menurut 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
Dapatkan 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
Membuat 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}
Klaim 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.

Minta perbandingan

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
Perbarui 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 yang mendetail

Content API for Shopping (Account)	Merchant API (Account)	Catatan
id	account_id	ID numerik kini menjadi kolom khusus output. ID utamanya adalah name resource.
name	account_name	Nama akun yang dapat dibaca manusia.
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. Objek ini menggantikan objek businessInformation di Content API for Shopping.

Minta perbandingan

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
Perbarui informasi bisnis	PUT /content/v2.1/{merchantId}/accounts/{accountId} (memperbarui atribut business_information)	PATCH /accounts/v1/accounts/{account}/businessInfo

Perbandingan kolom yang 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

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.

Minta perbandingan

Deskripsi permintaan	Content API for Shopping	Merchant API
Dapatkan 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
Halaman beranda klaim	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 yang 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.

Minta perbandingan

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 data 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 yang 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 khusus 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 (mengusulkan dan menerima).

Minta perbandingan

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 yang 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 penautan (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 informasi selengkapnya, lihat Pembaruan spesifikasi data produk Merchant Center 2025.

Mengelola identitas bisnis

Gunakan resource BusinessIdentity untuk mendeklarasikan sendiri atribut tentang bisnis Anda. Objek ini menggantikan objek businessIdentity di Content API for Shopping.

Minta perbandingan

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 yang 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 diganti dengan 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 akun dari Akun Multiklien yang diberikan. Akun tingkat lanjut di Merchant API jauh lebih canggih, sehingga memungkinkan jenis akun dan hubungan yang lebih luas. Untuk memungkinkan migrasi yang mudah bagi akun tingkat lanjut, 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.

Minta perbandingan

Deskripsi permintaan	Content API for Shopping	Merchant API
Mencantumkan akun dari akun tingkat lanjut	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.