כך תוכלו לשלב את Merchant Reports API עם ההטמעה הקיימת של Content API for Shopping.
Requests
כדי להשתמש ב-Merchant Reports API, צריך להשתמש בפורמט הבא של כתובת URL של בקשה:
POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
הנה השוואה לדוגמה בין Content API for Shopping ל-Merchant Reports API עבור בקשות של search
:
Content API | ממשק API של Merchant | |
כתובת URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search | https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search |
מזהים | {merchantId}
|
{parent}
|
שיטות
אפשר להריץ שאילתות ב-Merchant Reports API על ידי קריאה ל-method ReportService.Search
.
צפיות.
ב-Merchant API, שמות הטבלאות משתנים מ-CammelCase
ל-snake_case
.
MerchantPerformanceView
נקראת עכשיו product_performance_view
.
לפניכם מיפוי בין שמות הטבלאות ב-Content API for Shopping לבין Merchant API:
Content API | ממשק API של Merchant |
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
|
ב-Merchant API, כבר לא צריך לציין קידומת לשדה, לדוגמה segments.offer_id
. במקום זאת, צריך להשתמש בשם השדה, offer_id
.
הנה השוואה לדוגמה של שאילתות ב-Content API for Shopping וב-Merchant API:
Content API | ממשק API של Merchant |
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 |
זוהי דוגמה לתשובה:
Content API | ממשק API של Merchant |
{ "segments":{ "offerId":"abc" }, "metrics":{ "clicks":"123" } } |
{ "productPerformanceView" : { "offerId": "abc", "clicks": "123" } } |
אפשר להשתמש בשם הטבלה כקידומת של שדה. לדוגמה, אפשר להזין גם את offer_id
וגם את
product_performance_view.offer_id
בשאילתה של Merchant API.
ביצועים
אלה השינויים שבוצעו בתצוגת הביצועים ב-Merchant Reports API:
Content API | ממשק API של Merchant | התיאור |
segments.program : מחרוזת
|
marketing_method : מחרוזת
|
פלח program מוחלף בשדה marketing_method חדש. פרטים נוספים זמינים בערכים החדשים של marketing method .
|
metrics.ctr : דאבל
|
clickThroughRate : דאבל
|
שם המדד ctr השתנה ל-clickThroughRate
|
metrics.conversionValueMicros : מספר שלם
segments.currencyCode : מחרוזת
|
conversionValue: {
|
שדות המיקרו-מטבע ושדות המטבע ממוזגים לשדה אחד עם סוג Price
|
metrics.orders,
|
לא נתמכים | מדדי 'קונים ב-Google' לא נתמכים ב-Merchant Reports API |
הערכים של שיטות שיווק חדשות
זהו המיפוי בין הערכים segments.program
ל-marketing_method
:
Content API | ממשק API של Merchant |
SHOPPING_ADS
|
ADS
|
FREE_PRODUCT_LISTING
|
ORGANIC
|
FREE_LOCAL_PRODUCT_LISTING
|
ORGANIC
|
BUY_ON_GOOGLE_LISTING
|
לא נתמכים |
מוצר
אלה השינויים שבוצעו בתצוגת המוצרים ב-Merchant Reports API:
Content API | ממשק API של Merchant | התיאור |
productView.id : מחרוזת
|
id : מחרוזת
|
פורמט השדה משתנה מ-channel:language:targetCountry:offerId ל-channel~language~feedLabel~offerId
|
productView.priceMicros : מספר שלם
productView.currencyCode : מחרוזת
|
price: {
|
שדות המיקרו-מטבע ושדות המטבע ממוזגים לשדה אחד עם סוג Price
|
productView.aggregated_destination_status : מחרוזת
|
aggregated_reporting_context_status : מחרוזת
|
השם של השדה aggregated_destination_status השתנה ל-aggregated_reporting_context_status , הערכים לא השתנו
|
productView.item_issues: [
|
item_issues: [
|
ההגדרה של ItemIssue השתנתה
|
לא נתמכים | feedLabel : מחרוזת
|
הוספת את השדה feedLabel
|
מדדי מחירים
אלה השינויים שחלו בתצוגה המפורטת של מדדי המחירים ב-Merchant Reports API:
Content API | ממשק API של Merchant | התיאור |
productView.id : מחרוזת
|
id : מחרוזת
|
פורמט השדה משתנה מ-channel:language:targetCountry:offerId ל-channel~language~feedLabel~offerId
|
productView.priceMicros : מספר שלם
productView.currencyCode : מחרוזת
|
price: {
|
שדות המיקרו-מטבע ושדות המטבע ממוזגים לשדה אחד עם סוג Price
|
priceInsights.suggestedPriceMicros : מספר שלם
priceInsights.suggestedPriceCurrencyCode : מחרוזת
|
suggestedPrice: {
|
שדות המיקרו-מטבע ושדות המטבע ממוזגים לשדה אחד עם סוג Price
|
priceInsights.predictedGrossProfitChangeFraction : כפול
priceInsights.predictedMonthlyGrossProfitChangeMicros : מספר שלם
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode : מחרוזת
|
לא נתמכים | שדות שקשורים לשינוי ברווח ברוטו לא נתמכים ב-Merchant Reports API |
תחרותיות במחיר
אלו השינויים שבוצעו בתצוגה'השוואת מחירים ביחס לשוק' ב-Merchant Reports API:
Content API | ממשק API של Merchant | התיאור |
productView.id : מחרוזת
|
id : מחרוזת
|
פורמט השדה משתנה מ-channel:language:targetCountry:offerId ל-channel~language~feedLabel~offerId
|
productView.priceMicros : מספר שלם
productView.currencyCode : מחרוזת
|
price: {
|
שדות המיקרו-מטבע ושדות המטבע ממוזגים לשדה אחד עם סוג Price
|
priceCompetitiveness.countryCode : מחרוזת
|
reportCountryCode : מחרוזת
|
השם של השדה countryCode השתנה ל-reportCountryCode
|
priceCompetitiveness.benchmarkPriceMicros : מספר שלם
priceCompetitiveness.benchmarkPriceCurrencyCode : מחרוזת
|
benchmarkPrice: {
|
שדות המיקרו-מטבע ושדות המטבע ממוזגים לשדה אחד עם סוג Price
|
המוצרים הכי נמכרים
אלה השינויים שבוצעו בתצוגות של המוצרים הכי נמכרים ב-Merchant Reports API:
Content API | ממשק API של Merchant | התיאור |
bestSellers.countryCode : מחרוזת
|
reportCountryCode : מחרוזת
|
השם של השדה countryCode השתנה ל-reportCountryCode
|
bestSellers.categoryId : INT
|
reportCategoryId : INT
|
השם של השדה categoryId השתנה ל-reportCategoryId
|
חשיפה תחרותית
אלה השינויים שחלו בתצוגות המפורטות של החשיפה התחרותית ב-Merchant Reports API:
Content API | ממשק API של Merchant | התיאור |
competitiveVisibility.countryCode : מחרוזת
|
reportCountryCode : מחרוזת
|
השם של השדה countryCode השתנה ל-reportCountryCode
|
competitiveVisibility.categoryId : מספר שלם
|
reportCategoryId : מספר שלם
|
השם של השדה categoryId השתנה ל-reportCategoryId
|