Dowiedz się, jak możesz zintegrować Raporty sprzedawcy API z dotychczasowym Content API dla Wdrożenie reklam produktowych.
Żądania
Użyj tego formatu adresu URL żądania na potrzeby interfejsu Merchant Reports API:
POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
Oto przykładowe porównanie Content API for Shopping z kontem sprzedawcy
Interfejs Reports API dla search żądań:
| Content API. | Interfejs API sprzedawcy | |
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search | https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search |
| Identyfikatory | {merchantId}
|
{parent}
|
Metody
Możesz przesłać zapytanie do interfejsu Merchant Reports API, wywołując metodę
ReportService.Search
.
Wyświetlenia
W interfejsie Merchant API nazwy tabel są zmieniane z CammelCase na snake_case.
MerchantPerformanceView to teraz product_performance_view.
Oto mapowanie nazw tabel w Content API for Shopping Interfejs API sprzedawcy:
| Content API. | Interfejs API sprzedawcy |
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
|
W interfejsie Merchant API określ prefiks pola, np. segments.offer_id
nie jest już wymagane. Zamiast tego użyj nazwy pola offer_id.
Oto przykładowe porównanie zapytań w Content API for Shopping i w interfejsie Interfejs API sprzedawcy:
| Content API. | Interfejs API sprzedawcy |
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
|
Oto przykładowa odpowiedź:
| Content API. | Interfejs API sprzedawcy |
{
"segments":{
"offerId":"abc"
},
"metrics":{
"clicks":"123"
}
}
|
{
"productPerformanceView" : {
"offerId": "abc",
"clicks": "123"
}
}
|
Nazwa tabeli może być używana jako prefiks pola. Na przykład: offer_id i
W zapytaniu do interfejsu Merchant API można używać wartości product_performance_view.offer_id.
Wyniki
Oto co się zmieniło w widoku skuteczności w interfejsie Merchant Reports API:
| Content API. | Interfejs API sprzedawcy | Opis |
segments.program: ciąg znaków
|
marketing_method: ciąg znaków
|
Segment program został zastąpiony nowym polem marketing_method. Więcej informacji znajdziesz w sekcji Nowe wartości parametru marketing method.
|
metrics.ctr: liczba zmiennoprzecinkowa
|
clickThroughRate: liczba zmiennoprzecinkowa
|
Nazwa danych „ctr” została zmieniona na clickThroughRate
|
metrics.conversionValueMicros: liczba całkowita
segments.currencyCode: ciąg znaków
|
conversionValue: {
|
Pola kwoty w mikro i wartości waluty są scalone w jedno pole o typie Price
|
metrics.orders,
|
Nieobsługiwane | Dane Kup przez Google nie są obsługiwane w interfejsie Merchant Reports API |
Nowe wartości metod marketingowych
Oto mapowanie między wartościami segments.program i marketing_method:
| Content API. | Interfejs API sprzedawcy |
SHOPPING_ADS
|
ADS
|
FREE_PRODUCT_LISTING
|
ORGANIC
|
FREE_LOCAL_PRODUCT_LISTING
|
ORGANIC
|
BUY_ON_GOOGLE_LISTING
|
Nieobsługiwane |
Produkt
Oto zmiany w widoku produktu w interfejsie Merchant Reports API:
| Content API. | Interfejs API sprzedawcy | Opis |
productView.id: ciąg znaków
|
id: ciąg znaków
|
Format pola zmienia się z channel:language:targetCountry:offerId na channel~language~feedLabel~offerId
|
productView.priceMicros: liczba całkowita
productView.currencyCode: ciąg znaków
|
price: {
|
Pola kwoty w mikro i wartości waluty są scalone w jedno pole o typie Price
|
productView.aggregated_destination_status: ciąg znaków
|
aggregated_reporting_context_status: ciąg znaków
|
Nazwa pola aggregated_destination_status została zmieniona na aggregated_reporting_context_status, wartości się nie zmieniły
|
productView.item_issues: [
|
item_issues: [
|
Definicja obiektu ItemIssue została zmieniona
|
| Nieobsługiwane | feedLabel: ciąg znaków
|
Wprowadzono pole feedLabel
|
Statystyki dotyczące cen
Oto zmiany w widoku statystyk dotyczących cen w interfejsie Merchant Reports API:
| Content API. | Interfejs API sprzedawcy | Opis |
productView.id: ciąg znaków
|
id: ciąg znaków
|
Format pola zmienia się z channel:language:targetCountry:offerId na channel~language~feedLabel~offerId
|
productView.priceMicros: liczba całkowita
productView.currencyCode: ciąg znaków
|
price: {
|
Pola kwoty w mikro i wartości waluty są scalone w jedno pole o typie Price
|
priceInsights.suggestedPriceMicros: liczba całkowita
priceInsights.suggestedPriceCurrencyCode: ciąg znaków
|
suggestedPrice: {
|
Pola kwoty w mikro i wartości waluty są scalone w jedno pole o typie Price
|
priceInsights.predictedGrossProfitChangeFraction: liczba zmiennoprzecinkowa
priceInsights.predictedMonthlyGrossProfitChangeMicros: liczba całkowita
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: ciąg znaków
|
Nieobsługiwane | Pola związane ze zmianą zysku brutto nie są obsługiwane w interfejsie Merchant Reports API |
Konkurencyjność cenowa
Oto, co się zmieniło w widoku konkurencyjności cenowej w raportach sprzedawców Interfejs API:
| Content API. | Interfejs API sprzedawcy | Opis |
productView.id: ciąg znaków
|
id: ciąg znaków
|
Format pola zmienia się z channel:language:targetCountry:offerId na channel~language~feedLabel~offerId
|
productView.priceMicros: liczba całkowita
productView.currencyCode: ciąg znaków
|
price: {
|
Pola kwoty w mikro i wartości waluty są scalone w jedno pole o typie Price
|
priceCompetitiveness.countryCode: ciąg znaków
|
reportCountryCode: ciąg znaków
|
Nazwa pola countryCode została zmieniona na reportCountryCode
|
priceCompetitiveness.benchmarkPriceMicros: liczba całkowita
priceCompetitiveness.benchmarkPriceCurrencyCode: ciąg znaków
|
benchmarkPrice: {
|
Pola kwoty w mikro i wartości waluty są scalone w jedno pole o typie Price
|
Bestsellery
Oto, co się zmieniło w widokach bestsellerów w interfejsie Merchant Reports API:
| Content API. | Interfejs API sprzedawcy | Opis |
bestSellers.countryCode: ciąg znaków
|
reportCountryCode: ciąg znaków
|
Nazwa pola countryCode została zmieniona na reportCountryCode
|
bestSellers.categoryId: int
|
reportCategoryId: int
|
Nazwa pola categoryId została zmieniona na reportCategoryId
|
Widoczność na tle konkurencji
Oto co się zmieniło w widokach widoczności na tle konkurencji w interfejsie Merchant Reports API:
| Content API. | Interfejs API sprzedawcy | Opis |
competitiveVisibility.countryCode: ciąg znaków
|
reportCountryCode: ciąg znaków
|
Nazwa pola countryCode została zmieniona na reportCountryCode
|
competitiveVisibility.categoryId: liczba całkowita
|
reportCategoryId: liczba całkowita
|
Nazwa pola categoryId została zmieniona na reportCategoryId
|