Bermigrasi dari accountstatuses ke Masalah Akun

Cara Anda mengambil masalah tingkat akun yang dapat memengaruhi produk dan kesehatan 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 guide.

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

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 secara langsung menggunakan metode accounts.issues.list.
• Data dampak terstruktur: Resource AccountIssue menyediakan kolom impactedDestinations mendetail. Kolom ini memberi Anda 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 name resource lengkap yang unik 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, metode ini hanya menampilkan masalah yang berlaku langsung untuk akun lanjutan tersebut. Metode 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/v1/accounts/ACCOUNT_ID/issues

Perbandingan URL permintaan

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/v1/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.

ID

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	Kolom 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 masalah.
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 untuk 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 lebih banyak struktur dan kejelasan.

Perbandingan kolom

Content API for Shopping	Merchant API	Deskripsi
accountLevelIssues (array di AccountStatus)	accountIssues (array di ListAccountIssuesResponse)	Masalah kini menjadi resource level atas khusus, bukan kolom bertingkat.
id (string)	name (string)	ID masalah kini berupa 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 bahwa kolom tersebut adalah URL.
severity (string)	severity (enum)	Tingkat keparahan kini berupa enum terstruktur (CRITICAL, ERROR, SUGGESTION) dan bukan string.
country (string), destination (string)	impactedDestinations (pesan berulang)	Dampak kini terstruktur 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.