Esegui la migrazione di accountstatuses ad Aggregate Product Statuses

È cambiata la modalità di recupero delle statistiche e dei problemi dei prodotti aggregati. La funzionalità precedentemente disponibile nella risorsa accountstatuses dell'API Content for Shopping è ora suddivisa in risorse dedicate nell'API Merchant. Questa guida spiega come eseguire la migrazione dell'integrazione per utilizzare la nuova aggregateProductStatuses risorsa.

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

Differenze principali

Ecco le principali differenze tra le funzionalità relative allo stato dei prodotti nell'API Content for Shopping e nell'API Merchant:

  • Risorse dedicate: la risorsa accountstatuses dell'API Content for Shopping è ora suddivisa. Nell'API Merchant, i problemi a livello di account sono disponibili tramite la accountissues risorsa, mentre le statistiche dei prodotti aggregate e i problemi a livello di articolo sono disponibili tramite la nuova aggregateProductStatuses risorsa.
  • Nuova struttura delle risorse: AggregateProductStatus è una nuova risorsa che rappresenta le statistiche e i problemi per una combinazione specifica di un contesto di generazione di report e un paese.
  • Meccanismo di filtro: anziché utilizzare parametri di query come destinations per selezionare i dati, l'API Merchant utilizza un metodo list con una filter stringa per eseguire query su contesti di generazione di report e paesi specifici.
  • Rimozione del campo canale: il campo channel non viene più utilizzato. Queste informazioni fanno ora parte implicitamente di reportingContext.

Richieste

L'API Merchant utilizza una richiesta GET con un parametro filter per recuperare gli stati dei prodotti aggregati.

GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses

Formato dell'URL della richiesta

Descrizione della richiesta API Content for Shopping API Merchant
Recupera statistiche e problemi dei prodotti GET /content/v2.1/{merchantId}/accountstatuses/{accountId} GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

Identificatori

La modalità di identificazione delle risorse è stata modificata per supportare la nuova struttura.

Formato dell'identificatore

Descrizione dell'identificatore API Content for Shopping API Merchant
Identificatore di risorse La risorsa è stata identificata da accountId. Sono state selezionate sezioni di dati specifiche con i parametri di query. Il nome della risorsa identifica in modo univoco i dati per un contesto di generazione di report e un paese specifici: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}.

Metodi

Il metodo per recuperare gli stati dei prodotti è stato aggiornato a un metodo list che supporta il filtro.

Metodo dell'API Content for Shopping Metodo dell'API Merchant Disponibilità e note
accountstatuses.get aggregateProductStatuses.list Il metodo accountstatuses.get ha restituito una singola risorsa contenente tutte le statistiche dei prodotti. Il nuovo metodo aggregateProductStatuses.list restituisce un elenco di risorse, una per ogni combinazione di contesto di generazione di report e paese. Utilizza il parametro filter per recuperare dati specifici. Per i problemi a livello di account, utilizza accountissues.list.

Modifiche dettagliate dei campi

I campi per le statistiche e i problemi dei prodotti sono stati aggiornati e ristrutturati nella nuova risorsa AggregateProductStatus.

API Content for Shopping API Merchant Descrizione
products aggregate_product_statuses L'array products viene sostituito dal campo ripetuto aggregate_product_statuses nella risposta dell'elenco.
destination reporting_context Il campo destination viene sostituito da reporting_context, che specifica il contesto del programma per le statistiche.
channel (nessun campo equivalente) Il campo channel viene rimosso. Queste informazioni fanno ora parte di reporting_context.
statistics stats L'oggetto statistics viene rinominato in stats. I nomi dei campi all'interno vengono convertiti in snake_case, ad esempio activeCount ora è active_count.
itemLevelIssues.servability item_level_issues.severity L'enumerazione servability viene sostituita dall'enumerazione severity per descrivere l'impatto di un problema.
itemLevelIssues.attributeName item_level_issues.attribute Il campo attributeName viene rinominato in attribute.
itemLevelIssues.documentation item_level_issues.documentation_uri Il campo documentation viene rinominato in documentation_uri.
itemLevelIssues.numItems item_level_issues.product_count Il campo numItems viene rinominato in product_count.
Indietro
Migrate accountstatuses to Account Issues
Avanti
Migrate user and access management