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 sull'integrità dell'account è cambiato. Rispetto alla risorsa accountstatuses dell'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 dei prodotti aggregati sono suddivisi. Consulta anche la nostra guida per eseguire la migrazione da accountstatuses a stati dei prodotti aggregati.

Differenze principali

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

  • Risorsa dedicata:i problemi dell'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 elencarli direttamente utilizzando il metodo accounts.issues.list.
  • Dati sull'impatto strutturati:la risorsa AccountIssue fornisce un campo impactedDestinations dettagliato. Questo campo fornisce una suddivisione chiara dell'impatto di un problema, inclusa la destinazione (ad esempio, gli 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 ne facilita l'elaborazione a livello di programmazione rispetto ai valori basati su stringhe nell'API Content for Shopping.
  • Identificatori standardizzati:ogni problema dell'account ha un name di risorsa completo e univoco 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 preferita. Questa operazione non era possibile nell'API Content for 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 vengono restituiti problemi per nessuno dei suoi subaccount. Nell'API Content for Shopping, il metodo accountstatuses.list restituiva gli stati di tutti i subaccount. Per ottenere i problemi di 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 delle richieste

Descrizione della richiesta API Content per Shopping API Merchant
Elencare 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 di account {MERCHANT_ID} e {ACCOUNT_ID} come parametri del percorso. {ACCOUNT_ID} come parametro del 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 ottenere i problemi di un singolo account, utilizza accounts.issues.list e specifica l'ID account. L'API Merchant non ha 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 dell'account specificato, non dei relativi subaccount. Per ottenere i problemi di 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 singole chiamate list per ogni account.

Modifiche dettagliate dei campi

I campi all'interno della risorsa dei problemi 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 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) Il campo è stato rinominato per maggiore 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 della richiesta) I nuovi parametri nella richiesta list consentono la localizzazione dei campi leggibili, come title e detail.
Indietro
Overview
Avanti
Migrate accountstatuses to Aggregate Product Statuses