Memigrasikan accountstatuses ke Aggregate Product Statuses

Cara Anda mengambil statistik dan masalah produk gabungan telah berubah. Fungsi yang sebelumnya tersedia di resource accountstatuses di Content API for Shopping kini dibagi menjadi resource khusus di Merchant API. Panduan ini menjelaskan cara memigrasikan integrasi Anda untuk menggunakan resource aggregateProductStatuses baru.

Catatan: Di Merchant API, masalah tingkat akun dan status produk gabungan dipisahkan. Tinjau juga panduan kami untuk bermigrasi dari accountstatuses ke masalah akun.

Perbedaan utama

Berikut perbedaan utama antara fitur status produk di Content API for Shopping dan Merchant API:

• Resource khusus: Resource accountstatuses dari Content API for Shopping kini dibagi. Di Merchant API, masalah tingkat akun tersedia melalui resource accountissues, sedangkan statistik produk gabungan dan masalah tingkat item tersedia melalui resource aggregateProductStatuses baru.
• Struktur resource baru: AggregateProductStatus adalah resource baru yang mewakili statistik dan masalah untuk kombinasi tertentu dari konteks pelaporan dan negara.
• Mekanisme pemfilteran: Alih-alih menggunakan parameter kueri seperti destinations untuk memilih data, Merchant API menggunakan metode list dengan string filter untuk membuat kueri konteks dan negara pelaporan tertentu.
• Penghapusan kolom channel: Kolom channel tidak digunakan lagi. Informasi ini sekarang secara implisit menjadi bagian dari reportingContext.

Permintaan

Merchant API menggunakan permintaan GET dengan parameter filter untuk mengambil status produk gabungan.

GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses

Format URL permintaan

Deskripsi permintaan	Content API for Shopping	Merchant API
Mendapatkan statistik dan masalah produk	GET /content/v2.1/{merchantId}/accountstatuses/{accountId}	GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

Pengenal

Cara mengidentifikasi resource telah berubah untuk mendukung struktur baru.

Format ID

Deskripsi ID	Content API for Shopping	Merchant API
ID Resource	Resource diidentifikasi oleh accountId. Slice data tertentu dipilih dengan parameter kueri.	Nama resource mengidentifikasi data secara unik untuk konteks pelaporan dan negara tertentu: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}.

Metode

Metode untuk mengambil status produk telah diupdate ke metode list yang mendukung pemfilteran.

Metode Content API for Shopping	Metode Merchant API	Ketersediaan & catatan
accountstatuses.get	aggregateProductStatuses.list	Metode accountstatuses.get menampilkan satu resource yang berisi semua statistik produk. Metode aggregateProductStatuses.list yang baru menampilkan daftar resource, satu untuk setiap kombinasi negara dan konteks pelaporan. Gunakan parameter filter untuk mengambil data tertentu. Untuk masalah tingkat akun, gunakan accountissues.list.

Perubahan kolom mendetail

Kolom untuk statistik dan masalah produk telah diperbarui dan disusun ulang dalam resource AggregateProductStatus baru.

Content API for Shopping	Merchant API	Deskripsi
products	aggregate_product_statuses	Array products digantikan oleh kolom berulang aggregate_product_statuses dalam respons daftar.
destination	reporting_context	Kolom destination diganti dengan reporting_context, yang menentukan konteks program untuk statistik.
channel	(tidak ada kolom yang setara)	Kolom channel dihapus. Informasi ini sekarang menjadi bagian dari reporting_context.
statistics	stats	Objek statistics diganti namanya menjadi stats. Nama kolom di dalamnya dikonversi menjadi snake_case, misalnya, activeCount kini menjadi active_count.
itemLevelIssues.servability	item_level_issues.severity	Enum servability digantikan oleh enum severity untuk mendeskripsikan dampak masalah.
itemLevelIssues.attributeName	item_level_issues.attribute	Kolom attributeName diganti namanya menjadi attribute.
itemLevelIssues.documentation	item_level_issues.documentation_uri	Kolom documentation diganti namanya menjadi documentation_uri.
itemLevelIssues.numItems	item_level_issues.product_count	Kolom numItems diganti namanya menjadi product_count.