Package google.shopping.merchant.reports.v1beta

Indice

ReportService

Servizio per il recupero di report e approfondimenti sui prodotti, sulle loro prestazioni e sull'ambiente competitivo su Google.

Cerca

rpc Search(SearchRequest) returns (SearchResponse)

Recupera un report definito da una query di ricerca. La risposta potrebbe contenere meno righe rispetto a quanto specificato da page_size. Utilizza next_page_token per determinare se devono essere richieste altre righe.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

BestSellersBrandView

Campi disponibili per la query nella tabella best_sellers_brand_view.

Report Più venduti con i brand più popolari.

I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.

Campi
report_date

Date

Data del report. Il valore di questo campo può essere solo uno dei seguenti:

  • Il primo giorno della settimana (lunedì) per i report settimanali,
  • Il primo giorno del mese per i report mensili.

Obbligatoria nella clausola SELECT. Se nella query non è specificata una condizione WHERE per report_date, viene restituito l'ultimo report settimanale o mensile disponibile.
report_granularity

ReportGranularityEnum

Granularità del report. Il ranking può avvenire nell'arco di una settimana o un mese.

Obbligatoria nella clausola SELECT. La condizione su report_granularity è obbligatoria nella clausola WHERE.
report_country_code

string

Paese in cui viene calcolata la classifica. Rappresentato nel formato ISO 3166.

Obbligatoria nella clausola SELECT. La condizione su report_country_code è obbligatoria nella clausola WHERE.
report_category_id

int64

ID categoria prodotto Google per il quale calcolare il ranking, rappresentato nella tassonomia dei prodotti di Google.

Obbligatoria nella clausola SELECT. Se nella query non viene specificata una condizione WHERE su report_category_id, vengono restituiti i ranking per tutte le categorie di primo livello.
brand

string

Nome del brand.
rank

int64

Popolarità del brand su annunci e piattaforme organiche, nella categoria e nel paese selezionati, in base al numero stimato di unità vendute.
previous_rank

int64

Ranking popolarità nella settimana o nel mese precedente.
relative_demand

RelativeDemandEnum

Domanda stimata rispetto al brand con il ranking popolarità più alto nella stessa categoria e nello stesso paese.
previous_relative_demand

RelativeDemandEnum

Domanda stimata rispetto al brand con il ranking popolarità più alto nella stessa categoria e nello stesso paese nella settimana o nel mese precedente.
relative_demand_change

RelativeDemandChangeTypeEnum

Variazione della domanda stimata. Se è salito, affondato o rimasto piatto.

BestSellersProductClusterView

Campi disponibili per la query nella tabella best_sellers_product_cluster_view.

Report Più venduti con i cluster di prodotti principali. Un cluster di prodotti è un raggruppamento per diverse offerte e varianti che rappresentano lo stesso prodotto, ad esempio Google Pixel 7.

I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.

Campi
report_date

Date

Data del report. Il valore di questo campo può essere solo uno dei seguenti:

  • Il primo giorno della settimana (lunedì) per i report settimanali,
  • Il primo giorno del mese per i report mensili.

Obbligatoria nella clausola SELECT. Se nella query non è specificata una condizione WHERE per report_date, viene restituito l'ultimo report settimanale o mensile disponibile.
variant_gtins[]

string

GTIN di varianti di esempio del cluster di prodotti.
report_granularity

ReportGranularityEnum

Granularità del report. Il ranking può avvenire nell'arco di una settimana o un mese.

Obbligatoria nella clausola SELECT. La condizione su report_granularity è obbligatoria nella clausola WHERE.
report_country_code

string

Paese in cui viene calcolata la classifica. Rappresentato nel formato ISO 3166.

Obbligatoria nella clausola SELECT. La condizione su report_country_code è obbligatoria nella clausola WHERE.
report_category_id

int64

ID categoria prodotto Google per il quale calcolare il ranking, rappresentato nella tassonomia dei prodotti di Google.

Obbligatoria nella clausola SELECT. Se nella query non viene specificata una condizione WHERE su report_category_id, vengono restituiti i ranking per tutte le categorie di primo livello.
title

string

Titolo del cluster di prodotti.
brand

string

Brand del cluster di prodotti.
category_l1

string

Categoria di prodotto (1° livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.
category_l2

string

Categoria di prodotto (2° livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.
category_l3

string

Categoria di prodotto (3o livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.
category_l4

string

Categoria di prodotto (4o livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.
category_l5

string

Categoria di prodotto (5o livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.
inventory_status

InventoryStatus

Indica se il cluster dei prodotti è IN_STOCK nell'origine dati di prodotto in almeno uno dei paesi, OUT_OF_STOCK nell'origine dati di prodotto in tutti i paesi o NOT_IN_INVENTORY.

Questo campo non tiene in considerazione il filtro relativo al paese del report Più venduti.
brand_inventory_status

InventoryStatus

Se nell'origine dati di prodotto è presente almeno un prodotto del brand IN_STOCK in almeno uno dei paesi, tutti i prodotti nell'origine dati di prodotto sono OUT_OF_STOCK in tutti i paesi o NOT_IN_INVENTORY.

Questo campo non tiene in considerazione il filtro relativo al paese del report Più venduti.
rank

int64

Popolarità del cluster di prodotti su annunci e piattaforme organiche, nella categoria e nel paese selezionati, in base al numero stimato di unità vendute.
previous_rank

int64

Ranking popolarità nella settimana o nel mese precedente.
relative_demand

RelativeDemandEnum

Domanda stimata in relazione al cluster di prodotti con il ranking popolarità più alto nella stessa categoria e nello stesso paese.
previous_relative_demand

RelativeDemandEnum

Domanda stimata in relazione al cluster di prodotti con il ranking popolarità più alto nella stessa categoria e nello stesso paese nella settimana o nel mese precedente.
relative_demand_change

RelativeDemandChangeTypeEnum

Variazione della domanda stimata. Se è salito, affondato o rimasto piatto.

InventoryStatus

Stato del cluster di prodotti o del brand nel tuo inventario.

Enum
INVENTORY_STATUS_UNSPECIFIED Non specificato.
IN_STOCK Un prodotto per questo cluster o brand di prodotti è disponibile.
OUT_OF_STOCK Hai un prodotto per questo cluster di prodotti o brand nell'inventario, ma al momento non è disponibile.
NOT_IN_INVENTORY Non è presente un prodotto per questo cluster di prodotti o brand nell'inventario.

CompetitiveVisibilityBenchmarkView

Campi disponibili per la query nella tabella competitive_visibility_benchmark_view.

Report Scenario competitivo con il benchmark di categoria.

I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.

Campi
date

Date

Data di questa riga.

Obbligatoria nella clausola SELECT. Una condizione su date è obbligatoria nella clausola WHERE.
report_country_code

string

Paese in cui sono comparse le impressioni.

Obbligatoria nella clausola SELECT. Una condizione su report_country_code è obbligatoria nella clausola WHERE.
report_category_id

int64

ID categoria prodotto Google per il quale calcolare il report, rappresentato nella tassonomia dei prodotti di Google.

Obbligatoria nella clausola SELECT. Una condizione su report_category_id è obbligatoria nella clausola WHERE.
traffic_source

TrafficSourceEnum

Sorgente di traffico delle impressioni.

Obbligatoria nella clausola SELECT.
your_domain_visibility_trend

double

Variazione della visibilità basata sulle impressioni del dominio rispetto all'inizio dell'intervallo di tempo selezionato (o primo giorno con impressioni diverse da zero).

Non può essere filtrato nella clausola "WHERE".
category_benchmark_visibility_trend

double

Variazione della visibilità basata sulle impressioni rispetto all'inizio dell'intervallo di tempo selezionato (o primo giorno con impressioni diverse da zero) per un insieme combinato di commercianti con visibilità più elevata che si avvicina al mercato.

Non può essere filtrato nella clausola "WHERE".

CompetitiveVisibilityCompetitorView

Campi disponibili per la query nella tabella competitive_visibility_competitor_view.

Report Scenario competitivo con attività con visibilità simile.

I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.

Campi
date

Date

Data di questa riga.

Una condizione su date è obbligatoria nella clausola WHERE.
domain

string

Dominio del tuo concorrente o del tuo dominio, se "is_your_domain" è true.

Obbligatoria nella clausola SELECT. Non può essere filtrato nella clausola "WHERE".
is_your_domain

bool

True se questa riga contiene dati relativi al tuo dominio.

Non può essere filtrato nella clausola "WHERE".
report_country_code

string

Paese in cui sono comparse le impressioni.

Obbligatoria nella clausola SELECT. Una condizione su report_country_code è obbligatoria nella clausola WHERE.
report_category_id

int64

ID categoria prodotto Google per il quale calcolare il report, rappresentato nella tassonomia dei prodotti di Google.

Obbligatoria nella clausola SELECT. Una condizione su report_category_id è obbligatoria nella clausola WHERE.
traffic_source

TrafficSourceEnum

Sorgente di traffico delle impressioni.

Obbligatoria nella clausola SELECT.
rank

int64

Posizione del dominio nel ranking di attività simili per le chiavi selezionate (date, report_category_id, report_country_code, traffic_source) in base alle impressioni. 1 è il più alto.

Non può essere filtrato nella clausola "WHERE".
ads_organic_ratio

double

Il rapporto annunci / ricerca organica indica la frequenza con cui il dominio riceve impressioni dagli annunci Shopping rispetto al traffico organico. Il numero viene arrotondato e specificato in bucket.

Non può essere filtrato nella clausola "WHERE".
page_overlap_rate

double

Il tasso di sovrapposizione della pagina mostra la frequenza con cui le offerte dei rivenditori concorrenti vengono mostrate insieme alle tue offerte sulla stessa pagina.

Non può essere filtrato nella clausola "WHERE".
higher_position_rate

double

Il tasso di posizionamento superiore indica la frequenza con cui l'offerta di un concorrente è stata posizionata in una posizione più elevata nella pagina rispetto alla tua offerta.

Non può essere filtrato nella clausola "WHERE".
relative_visibility

double

La visibilità relativa mostra la frequenza con cui le offerte della concorrenza vengono mostrate rispetto alle tue. In altre parole, si tratta del numero di impressioni visualizzate di un rivenditore concorrente diviso per il numero di impressioni visualizzate durante l'intervallo di tempo selezionato per una categoria di prodotto e un paese selezionati.

Non può essere filtrato nella clausola "WHERE".

CompetitiveVisibilityTopMerchantView

Campi disponibili per la query nella tabella competitive_visibility_top_merchant_view.

Report Scenario competitivo con l'attività con la visibilità più alta.

I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.

Campi
date

Date

Data di questa riga.

Non può essere selezionato nella clausola SELECT. Una condizione su date è obbligatoria nella clausola WHERE.
domain

string

Dominio del tuo concorrente o del tuo dominio, se "is_your_domain" è true.

Obbligatoria nella clausola SELECT. Non può essere filtrato nella clausola "WHERE".
is_your_domain

bool

True se questa riga contiene dati relativi al tuo dominio.

Non può essere filtrato nella clausola "WHERE".
report_country_code

string

Paese in cui sono comparse le impressioni.

Obbligatoria nella clausola SELECT. Una condizione su report_country_code è obbligatoria nella clausola WHERE.
report_category_id

int64

ID categoria prodotto Google per il quale calcolare il report, rappresentato nella tassonomia dei prodotti di Google.

Obbligatoria nella clausola SELECT. Una condizione su report_category_id è obbligatoria nella clausola WHERE.
traffic_source

TrafficSourceEnum

Sorgente di traffico delle impressioni.

Obbligatoria nella clausola SELECT.
rank

int64

Posizione del dominio nel ranking dei commercianti migliori per le chiavi selezionate (date, report_category_id, report_country_code, traffic_source) in base alle impressioni. 1 è il più alto.

Non può essere filtrato nella clausola "WHERE".
ads_organic_ratio

double

Il rapporto annunci / ricerca organica indica la frequenza con cui il dominio riceve impressioni dagli annunci Shopping rispetto al traffico organico. Il numero viene arrotondato e specificato in bucket.

Non può essere filtrato nella clausola "WHERE".
page_overlap_rate

double

Il tasso di sovrapposizione della pagina mostra la frequenza con cui le offerte dei rivenditori concorrenti vengono mostrate insieme alle tue offerte sulla stessa pagina.

Non può essere filtrato nella clausola "WHERE".
higher_position_rate

double

Il tasso di posizionamento superiore indica la frequenza con cui l'offerta di un concorrente è stata posizionata in una posizione più elevata nella pagina rispetto alla tua offerta.

Non può essere filtrato nella clausola "WHERE".

MarketingMethod

Questo tipo non contiene campi.

Metodo di marketing utilizzato per promuovere i tuoi prodotti su Google (organica o annunci).

MarketingMethodEnum

Valori del metodo di marketing.

Enum
MARKETING_METHOD_ENUM_UNSPECIFIED Non specificato.
ORGANIC Marketing organico.
ADS Marketing basato sugli annunci.

NonProductPerformanceView

Campi disponibili per la query nella tabella non_product_performance_view.

Dati sul rendimento relativi a immagini e link ai negozi online che rimandano alle tue pagine non relative al prodotto. Sono incluse le metriche sul rendimento (ad es. clicks) e le dimensioni in base alle quali sono segmentate le metriche sul rendimento (ad es. date).

I campi dei segmenti non possono essere selezionati nelle query senza selezionare anche almeno un campo della metrica.

I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.

Campi
date

Date

Data nel fuso orario del commerciante a cui si applicano le metriche. Segmento.

La condizione su date è obbligatoria nella clausola WHERE.
week

Date

Primo giorno della settimana (lunedì) della data delle metriche nel fuso orario del commerciante. Segmento.
clicks

int64

Numero di clic sulle immagini e sui link dei negozi online che rimandano alle tue pagine non relative al prodotto. Metrica.
impressions

int64

Numero di volte in cui sono state mostrate immagini e link ai negozi online che rimandano alle tue pagine non relative al prodotto. Metrica.
click_through_rate

double

Percentuale di clic: il numero di clic (clicks) diviso per il numero di impressioni (impressions) delle immagini e dei link dei negozi online che rimandano alle tue pagine non inerenti al prodotto. Metrica.

PriceCompetitivenessProductView

Campi disponibili per la query nella tabella price_competitiveness_product_view.

Report Competitività del prezzo.

I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.

Campi
price

Price

Prezzo attuale del prodotto.
benchmark_price

Price

Ultimo benchmark prezzi disponibile per il catalogo del prodotto nel paese di riferimento.
report_country_code

string

Paese del benchmark prezzi. Rappresentato nel formato ISO 3166.

Obbligatoria nella clausola SELECT.
id

string

ID REST del prodotto, nel formato channel~languageCode~feedLabel~offerId. Può essere utilizzato per unire i dati alla tabella product_view.

Obbligatoria nella clausola SELECT.
offer_id

string

ID del prodotto fornito dal commerciante.
title

string

Titolo del prodotto.
brand

string

La marca del prodotto.
category_l1

string

Categoria di prodotto (1o livello) nella tassonomia dei prodotti di Google.
category_l2

string

Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google.
category_l3

string

Categoria di prodotto (3o livello) nella tassonomia dei prodotti di Google.
category_l4

string

Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google.
category_l5

string

Categoria di prodotto (5o livello) nella tassonomia dei prodotti di Google.
product_type_l1

string

Tipo di prodotto (1o livello) nella tassonomia dei prodotti del commerciante.
product_type_l2

string

Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante.
product_type_l3

string

Tipo di prodotto (3o livello) nella tassonomia dei prodotti del commerciante.
product_type_l4

string

Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante.
product_type_l5

string

Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante.

PriceInsightsProductView

Campi disponibili per la query nella tabella price_insights_product_view.

Report Approfondimenti sul prezzo.

I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.

Campi
price

Price

Prezzo attuale del prodotto.
suggested_price

Price

Ultimo prezzo suggerito per il prodotto.
effectiveness

Effectiveness

L'efficacia prevista dell'applicazione del suggerimento di prezzo, in bucket.
id

string

ID REST del prodotto, nel formato channel~languageCode~feedLabel~offerId. Può essere utilizzato per unire i dati alla tabella product_view.

Obbligatoria nella clausola SELECT.
offer_id

string

ID del prodotto fornito dal commerciante.
title

string

Titolo del prodotto.
brand

string

La marca del prodotto.
category_l1

string

Categoria di prodotto (1o livello) nella tassonomia dei prodotti di Google.
category_l2

string

Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google.
category_l3

string

Categoria di prodotto (3o livello) nella tassonomia dei prodotti di Google.
category_l4

string

Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google.
category_l5

string

Categoria di prodotto (5o livello) nella tassonomia dei prodotti di Google.
product_type_l1

string

Tipo di prodotto (1o livello) nella tassonomia dei prodotti del commerciante.
product_type_l2

string

Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante.
product_type_l3

string

Tipo di prodotto (3o livello) nella tassonomia dei prodotti del commerciante.
product_type_l4

string

Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante.
product_type_l5

string

Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante.
predicted_impressions_change_fraction

double

Variazione prevista delle impressioni in frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo attivo corrente. Ad esempio, 0,05 è un aumento previsto del 5% delle impressioni.
predicted_clicks_change_fraction

double

Variazione prevista dei clic in frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo attivo corrente. Ad esempio, 0,05 corrisponde a un aumento previsto dei clic del 5%.
predicted_conversions_change_fraction

double

Variazione prevista delle conversioni sotto forma di frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo attivo corrente. Ad esempio, 0,05 indica un aumento previsto delle conversioni del 5%.

Efficacia

Bucket di efficacia prevista.

L'efficacia indica quali prodotti trarrebbero vantaggio dalle variazioni di prezzo. Questa valutazione tiene conto dell'incremento del rendimento previsto modificando il prezzo scontato e la differenza tra il prezzo attuale e quello suggerito. Si prevede che i suggerimenti relativi ai prezzi con un'efficacia pari a HIGH generino il maggiore incremento del rendimento.

Enum
EFFECTIVENESS_UNSPECIFIED L'efficacia è sconosciuta.
LOW L'efficacia è bassa.
MEDIUM L'efficacia è media.
HIGH L'efficacia è elevata.

ProductPerformanceView

Campi disponibili per la query nella tabella product_performance_view.

Dati sul rendimento dei prodotti per il tuo account, incluse le metriche sul rendimento (ad es. clicks) e le dimensioni in base alle quali sono segmentate le metriche sul rendimento (ad es. offer_id). I valori delle dimensioni del prodotto, come offer_id, riflettono lo stato di un prodotto al momento dell'impressione.

I campi dei segmenti non possono essere selezionati nelle query senza selezionare anche almeno un campo della metrica.

I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.

Campi
date

Date

Data nel fuso orario del commerciante a cui si applicano le metriche. Segmento.

La condizione su date è obbligatoria nella clausola WHERE.
week

Date

Primo giorno della settimana (lunedì) della data delle metriche nel fuso orario del commerciante. Segmento.
conversion_value

Price

Valore delle conversioni attribuite al prodotto, registrato nella data di conversione. Metrica.

Disponibile solo per la sorgente di traffico FREE.
marketing_method

MarketingMethodEnum

Metodo di marketing a cui si applicano le metriche. Segmento.
customer_country_code

string

Codice del paese in cui si trova il cliente al momento dell'evento. Rappresentato nel formato ISO 3166. Segmento.

Se non è possibile determinare il paese del cliente, viene restituito un codice "ZZ" speciale.
offer_id

string

ID del prodotto fornito dal commerciante. Segmento.
title

string

Titolo del prodotto. Segmento.
brand

string

La marca del prodotto. Segmento.
category_l1

string

Categoria di prodotto (1° livello) nella tassonomia dei prodotti di Google. Segmento.
category_l2

string

Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google. Segmento.
category_l3

string

Categoria di prodotto (3o livello) nella tassonomia dei prodotti di Google. Segmento.
category_l4

string

Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google. Segmento.
category_l5

string

Categoria di prodotto (5o livello) nella tassonomia dei prodotti di Google. Segmento.
product_type_l1

string

Tipo di prodotto (1o livello) nella tassonomia dei prodotti del commerciante. Segmento.
product_type_l2

string

Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante. Segmento.
product_type_l3

string

Tipo di prodotto (3o livello) nella tassonomia dei prodotti del commerciante. Segmento.
product_type_l4

string

Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante. Segmento.
product_type_l5

string

Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante. Segmento.
custom_label0

string

Etichetta personalizzata 0 per il raggruppamento personalizzato dei prodotti. Segmento.
custom_label1

string

Etichetta personalizzata 1 per il raggruppamento personalizzato dei prodotti. Segmento.
custom_label2

string

Etichetta personalizzata 2 per il raggruppamento personalizzato dei prodotti. Segmento.
custom_label3

string

Etichetta personalizzata 3 per il raggruppamento personalizzato dei prodotti. Segmento.
custom_label4

string

Etichetta personalizzata 4 per il raggruppamento personalizzato dei prodotti. Segmento.
clicks

int64

Numero di clic. Metrica.
impressions

int64

Numero di volte in cui vengono mostrati i prodotti del commerciante. Metrica.
click_through_rate

double

Percentuale di clic: il numero di clic ricevuti dai prodotti del commerciante (clic) diviso per il numero di volte in cui i prodotti vengono mostrati (impressioni). Metrica.
conversions

double

Numero di conversioni attribuite al prodotto, registrate nella data di conversione. A seconda del modello di attribuzione, una conversione potrebbe essere distribuita tra più clic e a ogni clic viene assegnato il proprio merito. Questa metrica è la somma di tutti questi crediti. Metrica.

Disponibile solo per la sorgente di traffico FREE.
conversion_rate

double

Numero di conversioni diviso per il numero di clic, registrato alla data dell'impressione. Metrica.

Disponibile solo per la sorgente di traffico FREE.

ProductView

Campi disponibili per la query nella tabella product_view.

Prodotti disponibili nell'inventario corrente. I prodotti in questa tabella sono gli stessi dell'API secondaria Prodotti, ma non tutti gli attributi del prodotto dell'API secondaria Prodotti sono disponibili per le query in questa tabella. A differenza dell'API secondaria Prodotti, questa tabella consente di filtrare l'elenco dei prodotti restituito in base agli attributi del prodotto. Per recuperare un singolo prodotto in base a id o elencare tutti i prodotti, deve essere utilizzata l'API secondaria Prodotti.

I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.

Campi
price

Price

Prezzo prodotto Assente se le informazioni sul prezzo del prodotto non sono disponibili.
gtin[]

string

Elenco dei GTIN (Global Trade Item Number) del prodotto.
creation_time

Timestamp

L'ora in cui il commerciante ha creato il prodotto in secondi del timestamp.
expiration_date

Date

Data di scadenza del prodotto, specificata nell'inserimento.
item_issues[]

ItemIssue

Elenco dei problemi correlati all'articolo per il prodotto.

Questo campo non può essere utilizzato per ordinare i risultati.

Solo gli attributi selezionati di questo campo (ad esempio, item_issues.severity.aggregated_severity) possono essere utilizzati per filtrare i risultati.
click_potential

ClickPotential

Rendimento stimato della spesa rispetto ai prodotti del commerciante con il rendimento migliore.
id

string

ID REST del prodotto, nel formato channel~languageCode~feedLabel~offerId. I metodi dell'API Merchant Center che operano sui prodotti prendono questo parametro come parametro name.

Obbligatoria nella clausola SELECT.
channel

ChannelEnum

Il canale del prodotto. Può essere ONLINE o LOCAL.
language_code

string

Codice lingua del prodotto in formato BCP 47.
feed_label

string

Etichetta del feed del prodotto.
offer_id

string

ID del prodotto fornito dal commerciante.
title

string

Titolo del prodotto.
brand

string

La marca del prodotto.
category_l1

string

Categoria di prodotto (1o livello) nella tassonomia dei prodotti di Google.
category_l2

string

Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google.
category_l3

string

Categoria di prodotto (3o livello) nella tassonomia dei prodotti di Google.
category_l4

string

Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google.
category_l5

string

Categoria di prodotto (5o livello) nella tassonomia dei prodotti di Google.
product_type_l1

string

Tipo di prodotto (1o livello) nella tassonomia dei prodotti del commerciante.
product_type_l2

string

Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante.
product_type_l3

string

Tipo di prodotto (3o livello) nella tassonomia dei prodotti del commerciante.
product_type_l4

string

Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante.
product_type_l5

string

Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante.
condition

string

La condizione del prodotto.
availability

string

La disponibilità del prodotto.
shipping_label

string

Etichetta spedizione normalizzata specificata nell'origine dati.
item_group_id

string

ID gruppo di articoli fornito dal commerciante per raggruppare le varianti.
aggregated_reporting_context_status

AggregatedReportingContextStatus

Stato aggregato.
click_potential_rank

int64

Ranking del prodotto in base al suo potenziale in termini di clic. Un prodotto con click_potential_rank 1 ha il più alto potenziale in termini di clic tra i prodotti del commerciante che soddisfano le condizioni delle query di ricerca.

AggregatedReportingContextStatus

Stato del prodotto aggregato per tutti i contesti di report.

Ecco un esempio di come viene calcolato lo stato aggregato:

Schede senza costi Annunci Shopping Stato
Approved Approved ELIGIBLE
Approved In attesa ELIGIBLE
Approved Non approvato ELIGIBLE_LIMITED
In attesa In attesa IN ATTESA
Non approvato Non approvato NOT_ELIGIBLE_OR_DISAPPROVED
Enum
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED Non specificato.
NOT_ELIGIBLE_OR_DISAPPROVED Il prodotto non è idoneo o non è approvato per tutti i contesti di generazione dei report.
PENDING Lo stato del prodotto è in attesa in tutti i contesti di report.
ELIGIBLE_LIMITED Il prodotto è idoneo per alcuni (ma non tutti) contesti di segnalazione.
ELIGIBLE Il prodotto è idoneo per tutti i contesti di generazione di report.

ClickPotential

Il potenziale in termini di clic di un prodotto offre una stima del suo rendimento potenziale rispetto ai prodotti del commerciante con il rendimento migliore. Il potenziale in termini di clic di un prodotto aiuta i commercianti a dare la priorità ai prodotti da correggere, nonché a comprendere il rendimento dei prodotti rispetto al loro potenziale.

Enum
CLICK_POTENTIAL_UNSPECIFIED Impatto previsto sui clic previsti sconosciuto.
LOW Possibilità di ricevere un numero ridotto di clic rispetto ai prodotti del commerciante con il rendimento migliore.
MEDIUM Possibilità di ricevere un numero moderato di clic rispetto ai prodotti del commerciante con il rendimento migliore.
HIGH Possibilità di ricevere un numero di clic simile a quello dei prodotti del commerciante con il rendimento migliore.

ItemIssue

Problema dell'articolo associato al prodotto.

Campi
type

ItemIssueType

Tipo di problema dell'elemento.
severity

ItemIssueSeverity

Gravità del problema dell'articolo.
resolution

ItemIssueResolution

Risoluzione dei problemi relativi all'articolo.

ItemIssueResolution

Come risolvere il problema.

Enum
ITEM_ISSUE_RESOLUTION_UNSPECIFIED Non specificato.
MERCHANT_ACTION Il commerciante deve risolvere il problema.
PENDING_PROCESSING Il problema verrà risolto automaticamente (ad esempio, scansione dell'immagine) o tramite una revisione di Google. Al momento non è richiesta alcuna azione da parte del commerciante. La risoluzione potrebbe causare un altro problema (ad esempio, se la scansione non va a buon fine).

ItemIssueSeverity

In che modo il problema influisce sulla pubblicazione del prodotto.

Campi
severity_per_reporting_context[]

IssueSeverityPerReportingContext

Gravità del problema per contesto del report.
aggregated_severity

AggregatedIssueSeverity

Gravità aggregata del problema per tutti i contesti di report interessati.

Questo campo può essere utilizzato per filtrare i risultati.

AggregatedIssueSeverity

Gravità dei problemi aggregata per tutti i contesti di report.

Enum
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Non specificato.
DISAPPROVED Il problema disapprova il prodotto in almeno un contesto di report.
DEMOTED Il problema fa retrocedere il prodotto in tutti i contesti di report interessati.
PENDING La risoluzione del problema è PENDING_PROCESSING.

IssueSeverityPerReportingContext

Gravità del problema per contesto del report.

Campi
disapproved_countries[]

string

Elenco dei paesi non approvati nel contesto dei report, rappresentati in formato ISO 3166.
demoted_countries[]

string

Elenco dei paesi retrocessi nel contesto dei report, rappresentati in formato ISO 3166.
reporting_context

ReportingContextEnum

Contesto di segnalazione a cui si applica il problema.

ItemIssueType

Tipo di problema.

Campi
code

string

Codice di errore del problema, equivalente a code dei Problemi correlati ai prodotti.
canonical_attribute

string

Nome dell'attributo canonico per problemi specifici degli attributi.

RelativeDemand

Questo tipo non contiene campi.

Domanda relativa di un cluster di prodotti o di un brand nel report Più venduti.

RelativeDemandEnum

Valori della domanda relativa.

Enum
RELATIVE_DEMAND_ENUM_UNSPECIFIED Non specificato.
VERY_LOW La domanda è pari allo 0-5% della domanda del brand o cluster di prodotti con il ranking più alto.
LOW La domanda è pari al 6-10% della domanda del brand o cluster di prodotti con il ranking più alto.
MEDIUM La domanda è pari all'11-20% della domanda del brand o cluster di prodotti con il ranking più alto.
HIGH La domanda è pari al 21-50% della domanda del brand o cluster di prodotti con il ranking più alto.
VERY_HIGH La domanda corrisponde al 51-100% della domanda del brand o cluster di prodotti con il ranking più alto.

RelativeDemandChangeType

Questo tipo non contiene campi.

Domanda relativa di un cluster di prodotti o di un brand nel report Più venduti rispetto al periodo di tempo precedente.

RelativeDemandChangeTypeEnum

Valori del tipo di variazione della domanda relativa.

Enum
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED Non specificato.
SINKER La domanda relativa è inferiore rispetto al periodo di tempo precedente.
FLAT La domanda relativa è uguale al periodo di tempo precedente.
RISER La domanda relativa è più elevata rispetto al periodo di tempo precedente.

ReportGranularity

Questo tipo non contiene campi.

Granularità del report Più venduti. I report Più venduti vengono calcolati nell'arco di una settimana e un mese.

ReportGranularityEnum

Valori di granularità dei report.

Enum
REPORT_GRANULARITY_ENUM_UNSPECIFIED Non specificato.
WEEKLY Il report viene calcolato su un periodo di una settimana.
MONTHLY Il report viene calcolato su un periodo di tempo di un mese.

ReportRow

Riga dei risultati restituita dalla query di ricerca.

Nella risposta viene compilato solo il messaggio corrispondente alla tabella sottoposta a query. All'interno del messaggio compilato, vengono compilati solo i campi richiesti esplicitamente nella query.

Campi
product_performance_view

ProductPerformanceView

Campi disponibili per la query nella tabella product_performance_view.
non_product_performance_view

NonProductPerformanceView

Campi disponibili per la query nella tabella non_product_performance_view.
product_view

ProductView

Campi disponibili per la query nella tabella product_view.
price_competitiveness_product_view

PriceCompetitivenessProductView

Campi disponibili per la query nella tabella price_competitiveness_product_view.
price_insights_product_view

PriceInsightsProductView

Campi disponibili per la query nella tabella price_insights_product_view.
best_sellers_product_cluster_view

BestSellersProductClusterView

Campi disponibili per la query nella tabella best_sellers_product_cluster_view.
best_sellers_brand_view

BestSellersBrandView

Campi disponibili per la query nella tabella best_sellers_brand_view.
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

Campi disponibili per la query nella tabella competitive_visibility_competitor_view.
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

Campi disponibili per la query nella tabella competitive_visibility_top_merchant_view.
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

Campi disponibili per la query nella tabella competitive_visibility_benchmark_view.

SearchRequest

Messaggio di richiesta per il metodo ReportService.Search.

Campi
parent

string

Obbligatoria. ID dell'account che effettua la chiamata. Deve essere un account autonomo o un subaccount dell'AMC. Formato: accounts/{account}
query

string

Obbligatoria. Query che definisce un report da recuperare.

Per informazioni dettagliate su come creare la query, consulta la guida Linguaggio di query. Per l'elenco completo delle tabelle e dei campi disponibili, vedi Campi disponibili.
page_size

int32

Campo facoltativo. Numero di ReportRows da recuperare in una singola pagina. Il valore predefinito è 1000. I valori superiori a 5000 vengono forzati a 5000.
page_token

string

Campo facoltativo. Token della pagina da recuperare. Se non specificato, viene restituita la prima pagina dei risultati. Per richiedere la pagina di risultati successiva, deve essere utilizzato il valore ottenuto da next_page_token nella risposta precedente.

SearchResponse

Messaggio di risposta per il metodo ReportService.Search.

Campi
results[]

ReportRow

Righe che corrispondono alla query di ricerca.
next_page_token

string

Token che può essere inviato come page_token per recuperare la pagina successiva. Se omesso, non ci sono pagine successive.

TrafficSource

Questo tipo non contiene campi.

Sorgente di traffico delle impressioni nel report Scenario competitivo.

TrafficSourceEnum

Valori delle sorgenti di traffico.

Enum
TRAFFIC_SOURCE_ENUM_UNSPECIFIED Non specificato.
ORGANIC Traffico organico.
ADS Traffico proveniente dagli annunci.
ALL Traffico organico e dagli annunci pubblicitari.