Bermigrasi dari accountstatuses ke Masalah Akun

Cara Anda mengambil masalah tingkat akun yang dapat memengaruhi produk dan kualitas akun Anda telah berubah. Dibandingkan dengan resource accountstatuses di Content API for Shopping, Merchant API memperkenalkan resource AccountIssue khusus yang memberikan informasi yang lebih terstruktur dan mendetail.

Untuk mengetahui informasi selengkapnya tentang cara menggunakan fitur baru ini, lihat panduan Melihat masalah akun.

Perbedaan utama

Berikut adalah peningkatan dan perbedaan utama dalam resource AccountIssue Merchant API:

• Resource khusus: Masalah akun adalah resource tersendiri. Di Content API for Shopping, masalah tingkat akun adalah kolom bertingkat dalam resource AccountStatus umum. Dengan Merchant API, Anda dapat mencantumkannya langsung menggunakan metode accounts.issues.list.
• Data dampak terstruktur: Resource AccountIssue menyediakan kolom impactedDestinations yang mendetail. Kolom ini memberikan perincian yang jelas tentang dampak masalah, termasuk tujuan (misalnya, iklan Shopping), wilayah tertentu, dan tingkat keparahan masalah di wilayah tersebut.
• Tingkat keparahan sebagai enum: Kolom severity kini berupa enum (dengan nilai seperti CRITICAL, ERROR, SUGGESTION), sehingga lebih mudah diproses secara terprogram dibandingkan dengan nilai berbasis string di Content API for Shopping.
• ID standar: Setiap masalah akun memiliki resource lengkap yang unik name dalam format accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Pendekatan standar ini menggantikan string id dari Content API for Shopping.
• Dukungan pelokalan: Metode accounts.issues.list memungkinkan Anda menentukan language_code untuk menerima detail masalah, seperti judul dan deskripsi, dalam bahasa pilihan Anda. Hal ini tidak dapat dilakukan di Content API for Shopping.
• Perilaku akun lanjutan: Saat Anda memanggil accounts.issues.list di akun lanjutan, hanya masalah yang berlaku langsung untuk akun lanjutan tersebut yang ditampilkan. Fitur ini tidak menampilkan masalah untuk sub-akunnya. Di Content API for Shopping, metode accountstatuses.list akan menampilkan status untuk semua sub-akun. Untuk mendapatkan masalah untuk semua sub-akun di Merchant API, Anda harus memanggil accounts.listSubaccounts, lalu memanggil accounts.issues.list untuk setiap sub-akun satu per satu.

Permintaan

Di Merchant API, Anda dapat mencantumkan masalah akun untuk akun Merchant Center tertentu.

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/ACCOUNT_ID/issues

Meminta perbandingan URL

Deskripsi permintaan	Content API for Shopping	Merchant API
Mencantumkan masalah tingkat akun untuk satu akun	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID}	GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/issues
Mencantumkan masalah tingkat akun untuk semua sub-akun dari akun lanjutan	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	Tidak tersedia. Anda harus melakukan iterasi melalui sub-akun.

Pengenal

ID untuk akun dan masalah telah berubah di Merchant API.

Perbandingan ID

Deskripsi ID	Content API for Shopping	Merchant API
ID akun	{MERCHANT_ID} dan {ACCOUNT_ID} sebagai parameter jalur.	{ACCOUNT_ID} sebagai parameter jalur dalam format accounts/{ACCOUNT_ID}.
ID masalah	id di isi respons (misalnya, "products-that-enable-dishonest-behavior-hacking-policy").	Kolom name di isi respons, yang merupakan nama resource lengkap (misalnya, accounts/12345/issues/example-issue-id).

Metode

Metode untuk mengambil masalah akun telah digabungkan dan disederhanakan di Merchant API.

Perbandingan metode

Content API for Shopping	Merchant API	Ketersediaan & catatan
accountstatuses.get	accounts.issues.list	Tersedia. Untuk mendapatkan masalah untuk satu akun, gunakan accounts.issues.list dan tentukan ID akun. Merchant API tidak memiliki metode get untuk satu edisi.
accountstatuses.list	Tidak ada padanan langsung.	Tidak tersedia. Metode accounts.issues.list di Merchant API hanya menampilkan masalah untuk akun yang ditentukan, bukan sub-akunnya. Untuk mendapatkan masalah semua sub-akun, Anda harus memanggil accounts.listSubaccounts terlebih dahulu, lalu memanggil accounts.issues.list untuk setiap sub-akun.
accountstatuses.custombatch	Tidak ada padanan langsung.	Tidak tersedia. Pemrosesan batch untuk masalah akun tidak didukung di Merchant API. Anda harus melakukan panggilan list satu per satu untuk setiap akun.

Perubahan kolom mendetail

Kolom dalam resource masalah akun telah diperbarui untuk memberikan struktur dan kejelasan yang lebih baik.

Perbandingan kolom

Content API for Shopping	Merchant API	Deskripsi
accountLevelIssues (array di AccountStatus)	accountIssues (array di ListAccountIssuesResponse)	Masalah kini menjadi resource level teratas khusus, bukan kolom bertingkat.
id (string)	name (string)	ID masalah sekarang menjadi nama resource lengkap, misalnya accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (string)	title (string)	Tidak ada perubahan.
detail (string)	detail (string)	Tidak ada perubahan.
documentation (string)	documentationUri (string)	Kolom diganti namanya agar jelas untuk menunjukkan bahwa kolom tersebut adalah URL.
severity (string)	severity (enum)	Tingkat keparahan kini menjadi enum terstruktur (CRITICAL, ERROR, SUGGESTION) dan bukan string.
country (string), destination (string)	impactedDestinations (pesan berulang)	Dampak kini disusun dalam daftar, yang mengelompokkan tujuan, wilayah, dan tingkat keparahan untuk setiap area yang terpengaruh. Kolom country diganti dengan regionCode dalam pesan Impact.
(Tidak tersedia)	language_code, time_zone (parameter permintaan)	Parameter baru dalam permintaan list memungkinkan pelokalan kolom yang dapat dibaca manusia seperti title dan detail.