A continuación, se explica cómo integrar los informes de comerciante API con tu Content API existente para Shopping.
Solicitudes
Usa el siguiente formato de URL de solicitud para la API de Merchant Reports:
POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
A continuación, presentamos una comparación de ejemplo de Content API for Shopping con el comercio
API de informes para solicitudes de search:
| Content API | API de Merchant Center | |
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search | https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search |
| Identificadores | {merchantId}
|
{parent}
|
Métodos
Puedes consultar la API de Merchant Reports llamando al
ReportService.Search
.
Vistas
En la API de Merchant Center, los nombres de las tablas se cambian de CammelCase a snake_case.
MerchantPerformanceView ahora es product_performance_view
Esta es una asignación entre los nombres de las tablas en Content API for Shopping y los API de Merchant Center:
| Content API | API de Merchant Center |
MerchantPerformanceView
|
product_performance_view
|
ProductView
|
product_view
|
PriceCompetitivenesProductView
|
price_competitiveness_product_view
|
PriceInsightsProductView
|
price_insights_product_view
|
BestSellersBrandView
|
best_sellers_brand_view
|
BestSellersProductClusterView
|
best_sellers_product_cluster_view
|
CompetitiveVisibilityCompetitorView
|
competitive_visibility_competitor_view
|
CompetitiveVisibilityTopMerchantView
|
competitive_visibility_top_merchant_view
|
CompetitiveVisibilityBenchmarkView
|
competitive_visibility_benchmark_view
|
En la API de Merchant Center, especificar un prefijo de campo, por ejemplo, segments.offer_id
ya no es necesario. En su lugar, solo usa el nombre del campo, offer_id.
Este es un ejemplo de comparación de consultas en la Content API for Shopping y la API de Merchant Center:
| Content API | API de Merchant Center |
SELECT
segments.offer_id,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date DURING LAST_7_DAYS
|
SELECT
offer_id,
clicks
FROM product_performance_view
WHERE date DURING LAST_7_DAYS
|
Esta es una respuesta de ejemplo:
| Content API | API de Merchant Center |
{
"segments":{
"offerId":"abc"
},
"metrics":{
"clicks":"123"
}
}
|
{
"productPerformanceView" : {
"offerId": "abc",
"clicks": "123"
}
}
|
El nombre de la tabla se puede usar como un prefijo de campo. Por ejemplo, tanto offer_id como
Se aceptan product_performance_view.offer_id en la consulta a la API de Merchant Center.
Rendimiento
A continuación, se muestran los cambios que se realizaron en la vista de rendimiento en la API de Merchant Reports:
| Content API | API de Merchant Center | Descripción |
segments.program: string
|
marketing_method: string
|
Se reemplazó program segmento por un nuevo campo marketing_method. Consulta los nuevos valores de marketing method para obtener más información.
|
metrics.ctr: doble
|
clickThroughRate: doble
|
Se cambió el nombre de la métrica ctr a clickThroughRate
|
metrics.conversionValueMicros: número entero
segments.currencyCode: cadena
|
conversionValue: {
|
Los campos de cantidad en micros y moneda se combinan en un campo con el tipo Price
|
metrics.orders,
|
No compatible | Las métricas de Comprar con Google no son compatibles con la API de Merchant Reports |
Nuevos valores de métodos de marketing
Esta es la asignación entre los valores segments.program y marketing_method:
| Content API | API de Merchant Center |
SHOPPING_ADS
|
ADS
|
FREE_PRODUCT_LISTING
|
ORGANIC
|
FREE_LOCAL_PRODUCT_LISTING
|
ORGANIC
|
BUY_ON_GOOGLE_LISTING
|
No compatible |
Producto
A continuación, se muestran los cambios que se realizaron en la vista del producto en la API de Merchant Reports:
| Content API | API de Merchant Center | Descripción |
productView.id: string
|
id: string
|
El formato del campo cambia de channel:language:targetCountry:offerId a channel~language~feedLabel~offerId
|
productView.priceMicros: número entero
productView.currencyCode: cadena
|
price: {
|
Los campos de cantidad en micros y moneda se combinan en un campo con el tipo Price
|
productView.aggregated_destination_status: string
|
aggregated_reporting_context_status: string
|
Se cambió el nombre del campo aggregated_destination_status a aggregated_reporting_context_status; los valores no cambiaron
|
productView.item_issues: [
|
item_issues: [
|
Cambió la definición de ItemIssue
|
| No compatible | feedLabel: string
|
Se introdujo el campo feedLabel
|
Información sobre precios
A continuación, se muestran los cambios que se realizaron en la vista de estadísticas de precios en la API de Merchant Reports:
| Content API | API de Merchant Center | Descripción |
productView.id: string
|
id: string
|
El formato del campo cambia de channel:language:targetCountry:offerId a channel~language~feedLabel~offerId
|
productView.priceMicros: número entero
productView.currencyCode: cadena
|
price: {
|
Los campos de cantidad en micros y moneda se combinan en un campo con el tipo Price
|
priceInsights.suggestedPriceMicros: número entero
priceInsights.suggestedPriceCurrencyCode: cadena
|
suggestedPrice: {
|
Los campos de cantidad en micros y moneda se combinan en un campo con el tipo Price
|
priceInsights.predictedGrossProfitChangeFraction: doble
priceInsights.predictedMonthlyGrossProfitChangeMicros: número entero
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: cadena
|
No compatible | Los campos relacionados con el cambio de las ganancias brutas no se admiten en la API de Merchant Reports |
Competitividad de precios
A continuación, se muestran los cambios que se realizaron en la vista de competitividad de los precios en los Informes de Merchant Center API:
| Content API | API de Merchant Center | Descripción |
productView.id: string
|
id: string
|
El formato del campo cambia de channel:language:targetCountry:offerId a channel~language~feedLabel~offerId
|
productView.priceMicros: número entero
productView.currencyCode: cadena
|
price: {
|
Los campos de cantidad en micros y moneda se combinan en un campo con el tipo Price
|
priceCompetitiveness.countryCode: string
|
reportCountryCode: string
|
Se cambió el nombre del campo countryCode a reportCountryCode
|
priceCompetitiveness.benchmarkPriceMicros: número entero
priceCompetitiveness.benchmarkPriceCurrencyCode: cadena
|
benchmarkPrice: {
|
Los campos de cantidad en micros y moneda se combinan en un campo con el tipo Price
|
Los más vendidos
A continuación, te mostramos lo que cambió en las vistas más vendidas en la API de Merchant Reports:
| Content API | API de Merchant Center | Descripción |
bestSellers.countryCode: string
|
reportCountryCode: string
|
Se cambió el nombre del campo countryCode a reportCountryCode
|
bestSellers.categoryId: número entero
|
reportCategoryId: número entero
|
Se cambió el nombre del campo categoryId a reportCategoryId
|
Visibilidad respecto de la competencia
A continuación, se muestran los cambios que se realizaron en las vistas de visibilidad respecto a la competencia en la API de Merchant Reports:
| Content API | API de Merchant Center | Descripción |
competitiveVisibility.countryCode: string
|
reportCountryCode: string
|
Se cambió el nombre del campo countryCode a reportCountryCode
|
competitiveVisibility.categoryId: número entero
|
reportCategoryId: número entero
|
Se cambió el nombre del campo categoryId a reportCategoryId
|