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 baru aggregateProductStatuses.

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 adalah perbedaan utama antara fitur status produk di Content API for Shopping dan Merchant API:

• Resource khusus: Resource accountstatuses dari Content API untuk Shopping kini dipisahkan. Di Merchant API, masalah tingkat akun tersedia melalui resource, sedangkan statistik produk gabungan dan masalah tingkat item tersedia melalui resource baru.accountissuesaggregateProductStatuses
• Struktur resource baru: AggregateProductStatus adalah resource baru yang mewakili statistik dan masalah untuk kombinasi konteks pelaporan dan negara tertentu.
• Mekanisme pemfilteran: Merchant API menggunakan metode list dengan string filter untuk membuat kueri konteks pelaporan dan negara tertentu, bukan menggunakan parameter kueri seperti destinations untuk memilih data.
• Penghapusan kolom saluran: Kolom channel tidak lagi digunakan. Informasi ini kini 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

ID

Cara resource diidentifikasi telah berubah untuk mendukung struktur baru.

Format ID

Deskripsi ID	Content API for Shopping	Merchant API
ID Resource	Resource diidentifikasi berdasarkan accountId. Slice data tertentu dipilih dengan parameter kueri.	Nama resource secara unik mengidentifikasi data 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 baru menampilkan daftar resource, satu untuk setiap kombinasi konteks pelaporan dan negara. Gunakan parameter filter untuk mengambil data tertentu. Untuk masalah tingkat akun, gunakan accountissues.list.

Perubahan kolom mendetail

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

Content API for Shopping	Merchant API	Deskripsi
products	aggregate_product_statuses	Array products diganti dengan 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 kini menjadi bagian dari reporting_context.
statistics	stats	Objek statistics diganti namanya menjadi stats. Nama kolom di dalam diubah menjadi snake_case, misalnya, activeCount kini menjadi active_count.
itemLevelIssues.servability	item_level_issues.severity	Enum servability diganti dengan 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.