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.