Eseguire la migrazione da accountstatuses a Account Issues

Il modo in cui recuperi i problemi a livello di account che possono influire sui tuoi prodotti e sullo stato dell'account è cambiato. 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 saperne di più su come utilizzare la nuova funzionalità, consulta la guida Visualizza i problemi relativi all'account.

Nota: nell'API Merchant, i problemi a livello di account e gli stati aggregati dei prodotti sono separati. Consulta anche la nostra guida per eseguire la migrazione da accountstatuses agli stati dei prodotti aggregati.

Differenze principali

Ecco i principali miglioramenti e le differenze nella risorsa AccountIssue dell'API Merchant:

• Risorsa dedicata: i problemi relativi all'account sono una risorsa a sé stante. Nell'API Content for Shopping, i problemi a livello di account erano un campo nidificato all'interno della risorsa AccountStatus generale. Con l'API Merchant puoi elencarle direttamente utilizzando il metodo accounts.issues.list.
• Dati strutturati sull'impatto: la risorsa AccountIssue fornisce un campo impactedDestinations dettagliato. Questo campo fornisce una chiara suddivisione dell'impatto di un problema, tra cui la destinazione (ad esempio, annunci Shopping), la regione specifica e la gravità del problema in quella regione.
• Gravità come enum: il campo severity ora è un enum (con valori come CRITICAL, ERROR, SUGGESTION), il che semplifica l'elaborazione programmatica rispetto ai valori basati su stringhe nell'API Content for Shopping.
• Identificatori standardizzati: ogni problema relativo all'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 consente di specificare un language_code per ricevere i dettagli del problema, come il titolo e la descrizione, nella lingua che preferisci. Questa operazione non era possibile nell'API Content for Shopping.
• Comportamento dell'account avanzato: quando chiami accounts.issues.list su un account avanzato, vengono restituiti solo i problemi che si applicano direttamente a quell'account avanzato. Non restituisce i problemi relativi ai suoi subaccount. Nell'API Content for Shopping, il metodo accountstatuses.list restituiva gli stati di tutti i subaccount. Per ottenere i problemi per tutti i subaccount nell'API Merchant, devi chiamare accounts.listSubaccounts e poi 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/v1/accounts/ACCOUNT_ID/issues

Confronto degli URL di richiesta

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/v1/accounts/{ACCOUNT_ID}/issues
Elenca 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 eseguire l'iterazione dei subaccount.

Identificatori

Gli identificatori degli account e dei 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 di percorso.	{ACCOUNT_ID} come parametro di percorso nel formato accounts/{ACCOUNT_ID}.
Identificatore problema	Campo id nel corpo della risposta (ad esempio, "products-that-enable-dishonest-behavior-hacking-policy").	Campo name nel corpo della risposta, che è 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 visualizzare i problemi di un singolo account, utilizza accounts.issues.list e specifica l'ID account. L'API Merchant non dispone di un metodo get per un singolo problema.
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 suoi subaccount. Per ottenere i problemi relativi a 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 relativi all'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 ai problemi dell'account sono stati aggiornati per fornire maggiore struttura e chiarezza.

Confronto tra campi

API Content per Shopping	API Merchant	Descrizione
accountLevelIssues (array in AccountStatus)	accountIssues (array in ListAccountIssuesResponse)	I problemi ora sono una risorsa dedicata di primo livello, non un campo nidificato.
id (stringa)	name (stringa)	L'identificatore del problema ora è un nome completo della risorsa, ad esempio accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (stringa)	title (stringa)	Nessuna modifica.
detail (stringa)	detail (stringa)	Nessuna modifica.
documentation (stringa)	documentationUri (stringa)	Campo rinominato per chiarezza per indicare che si tratta di un URL.
severity (stringa)	severity (enum)	La gravità è ora un enum strutturato (CRITICAL, ERROR, SUGGESTION) anziché una stringa.
country (stringa), destination (stringa)	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 di richiesta)	I nuovi parametri nella richiesta list consentono la localizzazione di campi leggibili come title e detail.