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.

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

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/v1/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/v1/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 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.
Indietro
Overview
Avanti
Migrate accountstatuses to Aggregate Product Statuses