Esegui la migrazione di accountstatuses ad Aggregate Product Statuses

È cambiato il modo in cui recuperi le statistiche e i problemi aggregati dei prodotti. La funzionalità precedentemente disponibile nella risorsa accountstatuses dell'API Content per Shopping è ora suddivisa in risorse dedicate nell'API Merchant. Questa guida spiega come eseguire la migrazione dell'integrazione per utilizzare la nuova risorsa aggregateProductStatuses.

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 problemi relativi all'account.

Differenze principali

Di seguito sono riportate le principali differenze tra le funzionalità di stato del prodotto 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 risorsa accountissues, mentre le statistiche aggregate sui prodotti e i problemi a livello di articolo sono disponibili tramite la nuova risorsa aggregateProductStatuses.
• Nuova struttura delle risorse: AggregateProductStatus è una nuova risorsa che rappresenta le statistiche e i problemi per una combinazione specifica di un contesto di reporting e un paese.
• Meccanismo di filtraggio: anziché utilizzare parametri di query come destinations per selezionare i dati, l'API Merchant utilizza un metodo list con una stringa filter per eseguire query per paesi e contesti di reporting specifici.
• Rimozione del campo Canale: il campo channel non viene più utilizzato. Queste informazioni ora fanno 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 di richiesta

Descrizione della richiesta	API Content per Shopping	API Merchant
Visualizzare statistiche e problemi relativi ai prodotti	GET /content/v2.1/{merchantId}/accountstatuses/{accountId}	GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

Identificatori

Il modo in cui vengono identificate le risorse è cambiato per supportare la nuova struttura.

Formato dell'identificatore

Descrizione dell'identificatore	API Content per Shopping	API Merchant
Identificatore di risorse	La risorsa è stata identificata da accountId. Sono state selezionate sezioni di dati specifiche con i parametri della query.	Il nome della risorsa identifica in modo univoco i dati per un contesto di reporting 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 filtraggio.

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

Modifiche dettagliate ai campi

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

API Content per 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 è sostituito da reporting_context, che specifica il contesto del programma per le statistiche.
channel	(nessun campo equivalente)	Il campo channel viene rimosso. Queste informazioni ora fanno 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.