Eseguire la migrazione da accountstatuses a Account Issues

È cambiato il modo in cui recuperi i problemi a livello di account che possono influire sui tuoi prodotti e sullo stato dell'account. Rispetto alla risorsa accountstatuses nell'API Content for Shopping, l'API Merchant introduce una risorsa AccountIssue dedicata che fornisce informazioni più strutturate e dettagliate.

Per ulteriori informazioni su come utilizzare la nuova funzionalità, consulta la guida Visualizzare i problemi dell'account.

Differenze principali

Di seguito sono riportati i principali miglioramenti e le differenze nella risorsa API Merchant AccountIssue:

• Risorsa dedicata: i problemi dell'account sono una risorsa a parte. Nell'API Content per Shopping, i problemi a livello di account erano un campo nidificato all'interno della risorsa generale AccountStatus. Con l'API Merchant puoi elencarli direttamente utilizzando il metodo accounts.issues.list.
• Dati strutturati sull'impatto:la risorsa AccountIssue fornisce un campo impactedDestinations dettagliato. Questo campo fornisce una suddivisione chiara dell'impatto di un problema, inclusi la destinazione (ad esempio gli annunci Shopping), la regione specifica e la gravità del problema in quella regione.
• Gravità come enumerazione:il campo severity ora è un'enumerazione (con valori come CRITICAL, ERROR, SUGGESTION), il che lo rende più facile da elaborare a livello di programmazione rispetto ai valori basati su stringhe nell'API Content per Shopping.
• Identificatori standardizzati:ogni problema dell'account ha una risorsa completa univoca name nel formato accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Questo approccio standardizzato sostituisce la stringa id dell'API Content for Shopping.
• Supporto della localizzazione: il metodo accounts.issues.list ti consente di specificare un language_code per ricevere i dettagli del problema, come il titolo e la descrizione, nella tua lingua preferita. Non era possibile nell'API Content per Shopping.
• Comportamento avanzato dell'account:quando chiami accounts.issues.list su un account avanzato, vengono restituiti solo i problemi che si applicano direttamente a quell'account avanzato. Non restituisce problemi per nessuno dei suoi account secondari. Nell'API Content for Shopping, il metodo accountstatuses.list restituirebbe gli stati di tutti i subaccount. Per ottenere i problemi per tutti i subaccount nell'API Merchant, devi chiamare accounts.listSubaccounts e poi chiamare accounts.issues.list per ogni subaccount singolarmente.

Richieste

Nell'API Merchant, puoi elencare i problemi dell'account per un account Merchant Center specifico.

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

Richiedere il confronto degli URL

Descrizione della richiesta	API Content per Shopping	API Merchant
Elenca i problemi a livello di account per un singolo account	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID}	GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/issues
Elencare i problemi a livello di account per tutti i subaccount di un account avanzato	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	Non disponibile. Devi scorrere i subaccount.

Identificatori

Gli identificatori per account e problemi sono cambiati nell'API Merchant.

Confronto degli identificatori

Descrizione dell'identificatore	API Content per Shopping	API Merchant
Identificatore dell'account	{MERCHANT_ID} e {ACCOUNT_ID} come parametri del percorso.	{ACCOUNT_ID} come parametro di percorso nel formato accounts/{ACCOUNT_ID}.
Identificatore del problema	Campo id nel corpo della risposta (ad esempio, "products-that-enable-dishonest-behavior-hacking-policy").	name nel corpo della risposta, ovvero il nome completo della risorsa (ad esempio, accounts/12345/issues/example-issue-id).

Metodi

I metodi per recuperare i problemi dell'account sono stati consolidati e semplificati nell'API Merchant.

Confronto dei metodi

API Content per Shopping	API Merchant	Disponibilità e note
accountstatuses.get	accounts.issues.list	Disponibile. Per ottenere i problemi relativi a un singolo account, utilizza accounts.issues.list e specifica l'ID account. L'API Merchant non dispone di un metodo get per un singolo numero.
accountstatuses.list	Nessun equivalente diretto.	Non disponibile. Il metodo accounts.issues.list nell'API Merchant restituisce solo i problemi relativi all'account specificato, non ai relativi subaccount. Per ottenere i problemi per tutti i subaccount, devi prima chiamare accounts.listSubaccounts e poi accounts.issues.list per ogni subaccount.
accountstatuses.custombatch	Nessun equivalente diretto.	Non disponibile. L'elaborazione batch per i problemi dell'account non è supportata nell'API Merchant. Devi effettuare chiamate list individuali per ogni account.

Modifiche dettagliate ai campi

I campi all'interno della risorsa relativa al problema dell'account sono stati aggiornati per fornire maggiore struttura e chiarezza.

Confronto dei campi

API Content per Shopping	API Merchant	Descrizione
accountLevelIssues (array in AccountStatus)	accountIssues (array in ListAccountIssuesResponse)	I problemi sono ora una risorsa dedicata di primo livello, non un campo nidificato.
id (stringa)	name (stringa)	L'identificatore del problema ora è un nome risorsa completo, ad esempio accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (stringa)	title (stringa)	Nessuna modifica.
detail (stringa)	detail (stringa)	Nessuna modifica.
documentation (stringa)	documentationUri (stringa)	Il campo è stato rinominato per indicare chiaramente che si tratta di un URL.
severity (stringa)	severity (enum)	La gravità ora è un enum strutturato (CRITICAL, ERROR, SUGGESTION) anziché una stringa.
country (string), destination (string)	impactedDestinations (messaggio ripetuto)	L'impatto è ora strutturato in un elenco, che raggruppa la destinazione, la regione e la gravità per ogni area interessata. Il campo country viene sostituito da regionCode all'interno del messaggio Impact.
(Non disponibile)	language_code, time_zone (parametri della richiesta)	I nuovi parametri nella richiesta list consentono la localizzazione di campi leggibili come title e detail.