Package google.shopping.merchant.reports.v1beta

אינדקס

• ReportService (ממשק)
• BestSellersBrandView (הודעה)
• BestSellersProductClusterView (הודעה)
• BestSellersProductClusterView.InventoryStatus (טיפוסים בני מנייה (enum))
• CompetitiveVisibilityBenchmarkView (הודעה)
• CompetitiveVisibilityCompetitorView (הודעה)
• CompetitiveVisibilityTopMerchantView (הודעה)
• MarketingMethod (הודעה)
• MarketingMethod.MarketingMethodEnum (טיפוסים בני מנייה (enum))
• NonProductPerformanceView (הודעה)
• PriceCompetitivenessProductView (הודעה)
• PriceInsightsProductView (הודעה)
• PriceInsightsProductView.Effectiveness (טיפוסים בני מנייה (enum))
• ProductPerformanceView (הודעה)
• ProductView (הודעה)
• ProductView.AggregatedReportingContextStatus (טיפוסים בני מנייה (enum))
• ProductView.ClickPotential (טיפוסים בני מנייה (enum))
• ProductView.ItemIssue (הודעה)
• ProductView.ItemIssue.ItemIssueResolution (טיפוסים בני מנייה (enum))
• ProductView.ItemIssue.ItemIssueSeverity (הודעה)
• ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity (טיפוסים בני מנייה (enum))
• ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext (הודעה)
• ProductView.ItemIssue.ItemIssueType (הודעה)
• RelativeDemand (הודעה)
• RelativeDemand.RelativeDemandEnum (טיפוסים בני מנייה (enum))
• RelativeDemandChangeType (הודעה)
• RelativeDemandChangeType.RelativeDemandChangeTypeEnum (טיפוסים בני מנייה (enum))
• ReportGranularity (הודעה)
• ReportGranularity.ReportGranularityEnum (טיפוסים בני מנייה (enum))
• ReportRow (הודעה)
• SearchRequest (הודעה)
• SearchResponse (הודעה)
• TrafficSource (הודעה)
• TrafficSource.TrafficSourceEnum (טיפוסים בני מנייה (enum))

ReportService

שירות לאחזור דוחות ותובנות לגבי המוצרים שלכם, הביצועים שלהם והסביבה התחרותית שלהם ב-Google.

חיפוש
rpc Search(SearchRequest) returns (SearchResponse) אחזור דוח שהוגדר על ידי שאילתת חיפוש. התשובה עשויה להכיל פחות שורות ממה שצוין על ידי page_size. אפשר להסתמך על next_page_token כדי לבדוק אם יש עוד שורות לבקש. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: https://www.googleapis.com/auth/content למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

BestSellersBrandView

השדות הזמינים לשאילתה בטבלה best_sellers_brand_view.

דוח המוצרים הכי נמכרים עם מותגים מובילים.

הערכים מוגדרים רק לשדות שהתבקשו במפורש בשאילתת החיפוש של הבקשה.

שדות
report_date	Date תאריך הדוח. הערך בשדה הזה יכול להיות רק אחד מהערכים הבאים: היום הראשון בשבוע (יום שני) לדוחות שבועיים, היום הראשון בחודש לדוחות חודשיים. חובה בסעיף SELECT. אם התנאי WHERE ב-report_date לא מצוין בשאילתה, מוחזר הדוח השבועי או החודשי האחרון שזמין.
report_granularity	ReportGranularityEnum רמת הפירוט של הדוח. הדירוג יכול להתבצע במסגרת זמן של שבוע או חודש. חובה בסעיף SELECT. נדרש תנאי ב-report_granularity בסעיף WHERE.
report_country_code	string המדינה שבה הדירוג מחושב. מיוצג בפורמט ISO 3166. חובה בסעיף SELECT. נדרש תנאי ב-report_country_code בסעיף WHERE.
report_category_id	int64 מזהה קטגוריית המוצר ב-Google שעבורו יש לחשב את הדירוג, מיוצג בטקסונומיית המוצרים של Google. חובה בסעיף SELECT. אם התנאי WHERE ב-report_category_id לא מצוין בשאילתה, מוחזרים דירוגים לכל הקטגוריות ברמה העליונה.
brand	string שם המותג.
rank	int64 הפופולריות של המותג ב-Google Ads ובפלטפורמות האורגניות בקטגוריה ובמדינה שנבחרו, בהתבסס על המספר המשוער של היחידות שנמכרו.
previous_rank	int64 דירוג הפופולריות בשבוע או בחודש הקודם.
relative_demand	RelativeDemandEnum הביקוש המשוער ביחס למותג עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה.
previous_relative_demand	RelativeDemandEnum הביקוש המשוער ביחס למותג עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה בשבוע או בחודש הקודם.
relative_demand_change	RelativeDemandChangeTypeEnum שינוי בביקוש המשוער. בין אם הוא עלה, שקע או נותר שטוח.

BestSellersProductClusterView

השדות הזמינים לשאילתה בטבלה best_sellers_product_cluster_view.

דוח המוצרים הכי נמכרים כולל אשכולות מוצרים מובילים. אשכול מוצרים הוא קיבוץ של וריאציות ומוצרים שונים שמייצגים את אותו מוצר, למשל Google Pixel 7.

הערכים מוגדרים רק לשדות שהתבקשו במפורש בשאילתת החיפוש של הבקשה.

שדות
report_date	Date תאריך הדוח. הערך בשדה הזה יכול להיות רק אחד מהערכים הבאים: היום הראשון בשבוע (יום שני) לדוחות שבועיים, היום הראשון בחודש לדוחות חודשיים. חובה בסעיף SELECT. אם התנאי WHERE ב-report_date לא מצוין בשאילתה, מוחזר הדוח השבועי או החודשי האחרון שזמין.
variant_gtins[]	string מספרי GTIN של וריאציות לדוגמה של אשכול המוצרים.
report_granularity	ReportGranularityEnum רמת הפירוט של הדוח. הדירוג יכול להתבצע במסגרת זמן של שבוע או חודש. חובה בסעיף SELECT. נדרש תנאי ב-report_granularity בסעיף WHERE.
report_country_code	string המדינה שבה הדירוג מחושב. מיוצג בפורמט ISO 3166. חובה בסעיף SELECT. נדרש תנאי ב-report_country_code בסעיף WHERE.
report_category_id	int64 מזהה קטגוריית המוצר ב-Google שעבורו יש לחשב את הדירוג, מיוצג בטקסונומיית המוצרים של Google. חובה בסעיף SELECT. אם התנאי WHERE ב-report_category_id לא מצוין בשאילתה, מוחזרים דירוגים לכל הקטגוריות ברמה העליונה.
title	string השם של אשכול המוצרים.
brand	string המותג של אשכול המוצרים.
category_l1	string קטגוריית המוצרים (רמה ראשונה) של אשכול המוצרים, מיוצגת בטקסונומיית המוצרים של Google.
category_l2	string קטגוריית המוצרים (רמה שנייה) של אשכול המוצרים, מיוצגת בטקסונומיית המוצרים של Google.
category_l3	string קטגוריית המוצרים (רמה שלישית) של אשכול המוצרים, מיוצגת בטקסונומיית המוצרים של Google.
category_l4	string קטגוריית המוצרים (רמה רביעית) של אשכול המוצרים, מיוצגת בטקסונומיית המוצרים של Google.
category_l5	string קטגוריית המוצרים (רמה חמישית) של אשכול המוצרים, מיוצגת בטקסונומיית המוצרים של Google.
inventory_status	InventoryStatus אם אשכול המוצרים הוא IN_STOCK במקור נתוני המוצרים לפחות במדינה אחת, OUT_OF_STOCK במקור נתוני המוצרים בכל המדינות או NOT_IN_INVENTORY בכלל. בשדה הזה אין התייחסות למסנן המדינות בדוח 'המוצרים הכי נמכרים'.
brand_inventory_status	InventoryStatus גם אם יש כרגע מוצר אחד לפחות של המותג IN_STOCK במקור נתוני המוצרים שלכם באחת מהמדינות לפחות, כל המוצרים מופיעים במקור נתוני מוצרים של OUT_OF_STOCK בכל המדינות, או NOT_IN_INVENTORY. בשדה הזה אין התייחסות למסנן המדינות בדוח 'המוצרים הכי נמכרים'.
rank	int64 הפופולריות של אשכול המוצרים ב-Google Ads ובפלטפורמות אורגניות, בקטגוריה ובמדינה שנבחרו, בהתבסס על המספר המשוער של היחידות שנמכרו.
previous_rank	int64 דירוג הפופולריות בשבוע או בחודש הקודם.
relative_demand	RelativeDemandEnum הביקוש המשוער ביחס לאשכול המוצרים עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה.
previous_relative_demand	RelativeDemandEnum הביקוש המשוער ביחס לאשכול המוצרים עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה בשבוע או בחודש הקודם.
relative_demand_change	RelativeDemandChangeTypeEnum שינוי בביקוש המשוער. בין אם הוא עלה, שקע או נותר שטוח.

InventoryStatus

הסטטוס של אשכול המוצרים או המותג במלאי.

טיפוסים בני מנייה (enums)
INVENTORY_STATUS_UNSPECIFIED	לא צוין.
IN_STOCK	יש לכם במלאי מוצר או אשכול המוצרים הזה.
OUT_OF_STOCK	יש לך מוצר עבור אשכול המוצרים או המותג הזה במלאי, אבל הוא חסר במלאי כרגע.
NOT_IN_INVENTORY	אין לך מוצר באשכול המוצרים או במותג הזה במלאי.

CompetitiveVisibilityBenchmarkView

השדות הזמינים לשאילתה בטבלה competitive_visibility_benchmark_view.

דוח חשיפה תחרותית עם נקודת ההשוואה בקטגוריה.

הערכים מוגדרים רק לשדות שהתבקשו במפורש בשאילתת החיפוש של הבקשה.

שדות
date	Date התאריך של השורה הזו. חובה בסעיף SELECT. בסעיף WHERE נדרש תנאי ב-date.
report_country_code	string המדינה שבה הופיעו החשיפות. חובה בסעיף SELECT. בסעיף WHERE נדרש תנאי ב-report_country_code.
report_category_id	int64 מזהה קטגוריית המוצר ב-Google שעבורו רוצים לחשב את הדוח, מיוצג בטקסונומיית המוצרים של Google. חובה בסעיף SELECT. בסעיף WHERE נדרש תנאי ב-report_category_id.
traffic_source	TrafficSourceEnum מקור התנועה של חשיפות. חובה בסעיף SELECT.
your_domain_visibility_trend	double שינוי בחשיפה על סמך חשיפות של הדומיין ביחס להתחלת טווח הזמן שנבחר (או היום הראשון עם חשיפות שהן לא אפס). לא ניתן לסנן לפי בסעיף 'WHERE'.
category_benchmark_visibility_trend	double שינוי בחשיפה על סמך חשיפות ביחס להתחלת טווח הזמן שנבחר (או היום הראשון עם חשיפות שאינן אפס) עבור קבוצה משולבת של מוכרים שקיבלו אומדן של החשיפה הגבוהה ביותר לשוק. לא ניתן לסנן לפי בסעיף 'WHERE'.

CompetitiveVisibilityCompetitorView

השדות הזמינים לשאילתה בטבלה competitive_visibility_competitor_view.

דוח חשיפה תחרותית עם עסקים עם חשיפה דומה.

הערכים מוגדרים רק לשדות שהתבקשו במפורש בשאילתת החיפוש של הבקשה.

שדות
date	Date התאריך של השורה הזו. בסעיף WHERE נדרש תנאי ב-date.
domain	string הדומיין של המתחרה או של הדומיין, אם 'is_your_domain' מתקיים. חובה בסעיף SELECT. לא ניתן לסנן לפי בסעיף 'WHERE'.
is_your_domain	bool הערך הוא True אם השורה הזו מכילה נתונים לגבי הדומיין. לא ניתן לסנן לפי בסעיף 'WHERE'.
report_country_code	string המדינה שבה הופיעו החשיפות. חובה בסעיף SELECT. בסעיף WHERE נדרש תנאי ב-report_country_code.
report_category_id	int64 מזהה קטגוריית המוצר ב-Google שעבורו רוצים לחשב את הדוח, מיוצג בטקסונומיית המוצרים של Google. חובה בסעיף SELECT. בסעיף WHERE נדרש תנאי ב-report_category_id.
traffic_source	TrafficSourceEnum מקור התנועה של חשיפות. חובה בסעיף SELECT.
rank	int64 מיקום הדומיין בדירוג העסקים הדומים למפתחות שנבחרו (date, report_category_id, report_country_code, traffic_source) על סמך חשיפות. 1 הוא הגבוה ביותר. לא ניתן לסנן לפי בסעיף 'WHERE'.
ads_organic_ratio	double יחס מודעות / חיפוש אורגני מציג את התדירות שבה הדומיין מקבל חשיפות ממודעות שופינג בהשוואה לתנועה אורגנית. המספר מעוגל ומסווג. לא ניתן לסנן לפי בסעיף 'WHERE'.
page_overlap_rate	double שיעור החפיפה בדף: התדירות שבה מוצרים של קמעונאים מתחרים מוצגים יחד עם המוצרים שלכם באותו דף. לא ניתן לסנן לפי בסעיף 'WHERE'.
higher_position_rate	double שיעור מיקום גבוה יותר מציין את התדירות שבה מוצר של מתחרה הופיע בדף במיקום גבוה יותר מזה של המוצר שלכם. לא ניתן לסנן לפי בסעיף 'WHERE'.
relative_visibility	double חשיפה יחסית: התדירות שבה המוצרים של המתחרים שלכם מוצגים בהשוואה למוצרים שלכם. במילים אחרות, זהו מספר החשיפות של המוצרים של קמעונאי מתחרה חלקי מספר החשיפות של המוצרים בחנות בטווח הזמן שנבחר, בקטגוריית המוצרים ובמדינה שנבחרו. לא ניתן לסנן לפי בסעיף 'WHERE'.

CompetitiveVisibilityTopMerchantView

השדות הזמינים לשאילתה בטבלה competitive_visibility_top_merchant_view.

דוח חשיפה תחרותית עם העסק עם החשיפה הגבוהה ביותר.

הערכים מוגדרים רק לשדות שהתבקשו במפורש בשאילתת החיפוש של הבקשה.

שדות
date	Date התאריך של השורה הזו. לא ניתן לבחור בסעיף SELECT. בסעיף WHERE נדרש תנאי ב-date.
domain	string הדומיין של המתחרה או של הדומיין, אם 'is_your_domain' מתקיים. חובה בסעיף SELECT. לא ניתן לסנן לפי בסעיף 'WHERE'.
is_your_domain	bool הערך הוא True אם השורה הזו מכילה נתונים לגבי הדומיין. לא ניתן לסנן לפי בסעיף 'WHERE'.
report_country_code	string המדינה שבה הופיעו החשיפות. חובה בסעיף SELECT. בסעיף WHERE נדרש תנאי ב-report_country_code.
report_category_id	int64 מזהה קטגוריית המוצר ב-Google שעבורו רוצים לחשב את הדוח, מיוצג בטקסונומיית המוצרים של Google. חובה בסעיף SELECT. בסעיף WHERE נדרש תנאי ב-report_category_id.
traffic_source	TrafficSourceEnum מקור התנועה של חשיפות. חובה בסעיף SELECT.
rank	int64 מיקום הדומיין בדירוג המוכרים המובילים עבור המפתחות שנבחרו (date, report_category_id, report_country_code, traffic_source) על סמך חשיפות. 1 הוא הגבוה ביותר. לא ניתן לסנן לפי בסעיף 'WHERE'.
ads_organic_ratio	double יחס מודעות / חיפוש אורגני מציג את התדירות שבה הדומיין מקבל חשיפות ממודעות שופינג בהשוואה לתנועה אורגנית. המספר מעוגל ומסווג. לא ניתן לסנן לפי בסעיף 'WHERE'.
page_overlap_rate	double שיעור החפיפה בדף: התדירות שבה מוצרים של קמעונאים מתחרים מוצגים יחד עם המוצרים שלכם באותו דף. לא ניתן לסנן לפי בסעיף 'WHERE'.
higher_position_rate	double שיעור מיקום גבוה יותר מציין את התדירות שבה מוצר של מתחרה הופיע בדף במיקום גבוה יותר מזה של המוצר שלכם. לא ניתן לסנן לפי בסעיף 'WHERE'.

MarketingMethod

אין שדות בסוג הזה.

שיטת שיווק לקידום המוצרים שלך ב-Google (אורגני לעומת מודעות).

MarketingMethodEnum

הערכים של שיטת השיווק.

טיפוסים בני מנייה (enums)
MARKETING_METHOD_ENUM_UNSPECIFIED	לא צוין.
ORGANIC	שיווק אורגני.
ADS	שיווק מבוסס-מודעות.

NonProductPerformanceView

השדות הזמינים לשאילתה בטבלה non_product_performance_view.

נתוני ביצועים של תמונות וקישורים לחנות הווירטואלית שמובילים לדפים שהם לא דפי מוצרים. זה כולל מדדי ביצועים (לדוגמה, clicks) ומאפיינים שלפיהם מפולחים מדדי ביצועים (לדוגמה, date).

לא ניתן לבחור שדות פילוח בשאילתות בלי לבחור גם שדה מדד אחד לפחות.

הערכים מוגדרים רק לשדות שהתבקשו במפורש בשאילתת החיפוש של הבקשה.

שדות
date	Date התאריך באזור הזמן של המוכר שעליו המדדים חלים. פילוח. נדרש תנאי ב-date בסעיף WHERE.
week	Date היום הראשון בשבוע (יום שני) של תאריך המדדים באזור הזמן של המוכר. פילוח.
clicks	int64 מספר הקליקים על תמונות וקישורים לחנות הווירטואלית שהובילו לדפים שאינם מוצרים. מדד.
impressions	int64 מספר הפעמים שבהן הוצגו תמונות וקישורים לחנות הווירטואלית שהובילו לדפים שאינם דפי מוצרים. מדד.
click_through_rate	double שיעור הקליקים - מספר הקליקים (clicks) חלקי מספר החשיפות (impressions) של תמונות וקישורים לחנות הווירטואלית שמובילים לדפים שלך שהם לא דפי מוצרים. מדד.

PriceCompetitivenessProductView

השדות הזמינים לשאילתה בטבלה price_competitiveness_product_view.

השוואת מחירים ביחס לשוק.

הערכים מוגדרים רק לשדות שהתבקשו במפורש בשאילתת החיפוש של הבקשה.

שדות
price	Price המחיר הנוכחי של המוצר.
benchmark_price	Price המחיר המקובל כרגע בתעשייה לקטלוג המוצר במדינת היעד.
report_country_code	string המדינה שבה נמצא המחיר המקובל בשוק. מיוצג בפורמט ISO 3166. חובה בסעיף SELECT.
id	string מזהה REST של המוצר, בצורת channel~languageCode~feedLabel~offerId. אפשר להשתמש בה כדי לצרף נתונים לטבלה product_view. חובה בסעיף SELECT.
offer_id	string המזהה של המוצר שסופק על ידי המוֹכר.
title	string שם המוצר.
brand	string המותג של המוצר.
category_l1	string קטגוריית המוצר (רמה ראשונה) בטקסונומיית המוצרים של Google.
category_l2	string קטגוריית המוצר (רמה שנייה) בטקסונומיית המוצרים של Google.
category_l3	string קטגוריית מוצר (רמה שלישית) בטקסונומיית המוצרים של Google.
category_l4	string קטגוריית המוצר (רמה רביעית) בטקסונומיית המוצרים של Google.
category_l5	string קטגוריית המוצר (רמה חמישית) בטקסונומיית המוצרים של Google.
product_type_l1	string סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר עצמו.
product_type_l2	string סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר.
product_type_l3	string סוג המוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר עצמו.
product_type_l4	string סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר עצמו.
product_type_l5	string סוג המוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר.

PriceInsightsProductView

השדות הזמינים לשאילתה בטבלה price_insights_product_view.

מדדי מחירים.

הערכים מוגדרים רק לשדות שהתבקשו במפורש בשאילתת החיפוש של הבקשה.

שדות
price	Price המחיר הנוכחי של המוצר.
suggested_price	Price המחיר המוצע האחרון של המוצר.
effectiveness	Effectiveness היעילות החזויה של יישום הצעת המחיר, המחולקת לקטגוריות.
id	string מזהה REST של המוצר, בצורת channel~languageCode~feedLabel~offerId. אפשר להשתמש בה כדי לצרף נתונים לטבלה product_view. חובה בסעיף SELECT.
offer_id	string המזהה של המוצר שסופק על ידי המוֹכר.
title	string שם המוצר.
brand	string המותג של המוצר.
category_l1	string קטגוריית המוצר (רמה ראשונה) בטקסונומיית המוצרים של Google.
category_l2	string קטגוריית המוצר (רמה שנייה) בטקסונומיית המוצרים של Google.
category_l3	string קטגוריית מוצר (רמה שלישית) בטקסונומיית המוצרים של Google.
category_l4	string קטגוריית המוצר (רמה רביעית) בטקסונומיית המוצרים של Google.
category_l5	string קטגוריית המוצר (רמה חמישית) בטקסונומיית המוצרים של Google.
product_type_l1	string סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר עצמו.
product_type_l2	string סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר.
product_type_l3	string סוג המוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר עצמו.
product_type_l4	string סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר עצמו.
product_type_l5	string סוג המוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר.
predicted_impressions_change_fraction	double השינוי הצפוי במספר החשיפות כשבר אחרי השקת המחיר המומלץ, בהשוואה למחיר הפעיל הנוכחי. לדוגמה, הערך 0.05 מציין עלייה חזויה של 5% במספר החשיפות.
predicted_clicks_change_fraction	double השינוי הצפוי בקליקים כשבר לאחר הצגת המחיר המוצע בהשוואה למחיר הפעיל הנוכחי. לדוגמה, הערך 0.05 מציין עלייה חזויה של 5% במספר הקליקים.
predicted_conversions_change_fraction	double השינוי הצפוי בהמרות כשבר אחרי השקת המחיר המומלץ, בהשוואה למחיר הפעיל הנוכחי. לדוגמה, הערך 0.05 מציין עלייה חזויה של 5% בהמרות).

אפקטיביות

קטגוריית היעילות החזויה.

המדד 'יעילות' מציין לאילו מוצרים יש את הביצועים הטובים ביותר בעקבות שינויים במחיר. בדירוג הזה נלקחים בחשבון שיפור הביצועים החזוי על ידי התאמת מחיר המבצע וההפרש בין המחיר הנוכחי שלכם לבין המחיר המוצע. הצעות למחירים עם יעילות של HIGH צפויות להביא לעלייה הגדולה ביותר בביצועים.

טיפוסים בני מנייה (enums)
EFFECTIVENESS_UNSPECIFIED	היעילות לא ידועה.
LOW	היעילות נמוכה.
MEDIUM	היעילות היא בינונית.
HIGH	מידת האפקטיביות גבוהה.

ProductPerformanceView

השדות הזמינים לשאילתה בטבלה product_performance_view.

נתוני ביצועי מוצרים בחשבון שלך, כולל מדדי ביצועים (לדוגמה, clicks) ומאפיינים שלפיהם מפולחים מדדי ביצועים (לדוגמה, offer_id). הערכים של מאפייני מוצר, למשל offer_id, משקפים את מצב המוצר בזמן החשיפה.

לא ניתן לבחור שדות פילוח בשאילתות בלי לבחור גם שדה מדד אחד לפחות.

הערכים מוגדרים רק לשדות שהתבקשו במפורש בשאילתת החיפוש של הבקשה.

שדות
date	Date התאריך באזור הזמן של המוכר שעליו המדדים חלים. פילוח. נדרש תנאי ב-date בסעיף WHERE.
week	Date היום הראשון בשבוע (יום שני) של תאריך המדדים באזור הזמן של המוכר. פילוח.
conversion_value	Price ערך ההמרות שמשויכות למוצר, כפי שדווח בתאריך ההמרה. מדד. זמין רק עבור מקור התנועה FREE.
marketing_method	MarketingMethodEnum שיטת השיווק שעליה רלוונטיים המדדים. פילוח.
customer_country_code	string קוד המדינה שבה הלקוח נמצא בזמן האירוע. מיוצג בפורמט ISO 3166. פילוח. אם לא ניתן לקבוע את מדינת הלקוח, מוחזר קוד 'ZZ' מיוחד.
offer_id	string המזהה של המוצר שסופק על ידי המוֹכר. פילוח.
title	string שם המוצר. פילוח.
brand	string המותג של המוצר. פילוח.
category_l1	string קטגוריית מוצר (רמה ראשונה) בטקסונומיית המוצרים של Google. פילוח.
category_l2	string קטגוריית מוצרים (רמה שנייה) בטקסונומיית המוצרים של Google. פילוח.
category_l3	string קטגוריית מוצר (רמה שלישית) בטקסונומיית המוצרים של Google. פילוח.
category_l4	string קטגוריית מוצר (רמה רביעית) בטקסונומיית המוצרים של Google. פילוח.
category_l5	string קטגוריית מוצר (רמה חמישית) בטקסונומיית המוצרים של Google. פילוח.
product_type_l1	string סוג מוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר. פילוח.
product_type_l2	string סוג מוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר. פילוח.
product_type_l3	string סוג מוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר. פילוח.
product_type_l4	string סוג מוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר. פילוח.
product_type_l5	string סוג מוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר. פילוח.
custom_label0	string תווית מותאמת אישית 0 לקיבוץ מוצרים בהתאמה אישית. פילוח.
custom_label1	string תווית מותאמת אישית 1 לקיבוץ מוצרים בהתאמה אישית. פילוח.
custom_label2	string תווית מותאמת אישית 2 לקיבוץ מוצרים בהתאמה אישית. פילוח.
custom_label3	string תווית מותאמת אישית 3 לקיבוץ מוצרים בהתאמה אישית. פילוח.
custom_label4	string תווית מותאמת אישית 4 לקיבוץ מוצרים בהתאמה אישית. פילוח.
clicks	int64 מספר קליקים. מדד.
impressions	int64 מספר הפעמים שהמוצרים של המוֹכר מוצגים. מדד.
click_through_rate	double שיעור קליקים – מספר הקליקים שהמוצרים של המוכר מקבלים (קליקים) חלקי מספר הפעמים שהמוצרים מוצגים (חשיפות). מדד.
conversions	double מספר ההמרות שמשויכות למוצר, שדווחו בתאריך ההמרה. בהתאם למודל השיוך, המרה יכולה להתחלק בין מספר קליקים, ולכל קליק מוקצה קרדיט משלו. המדד הזה הוא הסכום של כל הזיכויים האלה. מדד. זמין רק עבור מקור התנועה FREE.
conversion_rate	double מספר ההמרות חלקי מספר הקליקים, שדווחו בתאריך החשיפה. מדד. זמין רק עבור מקור התנועה FREE.

ProductView

השדות הזמינים לשאילתה בטבלה product_view.

מוצרים במלאי הנוכחי. המוצרים בטבלה הזו זהים למוצרים ב-API המשני של המוצרים, אבל לא כל מאפייני המוצרים מה-API המשני של המוצרים זמינים לשאילתה בטבלה הזו. בניגוד ל-API המשני של המוצרים, הטבלה הזו מאפשרת לסנן את רשימת המוצרים שהוחזרה לפי מאפייני מוצרים. כדי לאחזר מוצר בודד עד id או כדי להציג את כל המוצרים, צריך להשתמש ב-API המשני של המוצרים.

הערכים מוגדרים רק לשדות שהתבקשו במפורש בשאילתת החיפוש של הבקשה.

שדות
price	Price מחיר המוצר. המאפיין חסר אם המידע על מחיר המוצר לא זמין.
gtin[]	string רשימת מספרי הפריט המסחרי הגלובלי (GTIN) של המוצר.
creation_time	Timestamp השעה שהמוכר יצר את המוצר, בשניות בחותמת הזמן.
expiration_date	Date תאריך התפוגה של המוצר, שצוין בזמן ההוספה.
item_issues[]	ItemIssue רשימת בעיות בפריטים של המוצר. אי אפשר להשתמש בשדה הזה למיון התוצאות. אפשר להשתמש רק במאפיינים שנבחרו בשדה הזה (לדוגמה, item_issues.severity.aggregated_severity) לסינון התוצאות.
click_potential	ClickPotential פוטנציאל ביצועים משוער בהשוואה למוצרים של המוֹכר בעלי הביצועים הטובים ביותר.
id	string מזהה REST של המוצר, בצורת channel~languageCode~feedLabel~offerId. ב-methods של Merchant API שפועלים על מוצרים, הפרמטר name מקבל את הערך הזה. חובה בסעיף SELECT.
channel	ChannelEnum הערוץ של המוצר. יכול להיות ONLINE או LOCAL.
language_code	string קוד השפה של המוצר בפורמט BCP 47.
feed_label	string תווית הפיד של המוצר.
offer_id	string המזהה של המוצר שסופק על ידי המוֹכר.
title	string שם המוצר.
brand	string המותג של המוצר.
category_l1	string קטגוריית המוצר (רמה ראשונה) בטקסונומיית המוצרים של Google.
category_l2	string קטגוריית המוצר (רמה שנייה) בטקסונומיית המוצרים של Google.
category_l3	string קטגוריית מוצר (רמה שלישית) בטקסונומיית המוצרים של Google.
category_l4	string קטגוריית המוצר (רמה רביעית) בטקסונומיית המוצרים של Google.
category_l5	string קטגוריית המוצר (רמה חמישית) בטקסונומיית המוצרים של Google.
product_type_l1	string סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר עצמו.
product_type_l2	string סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר.
product_type_l3	string סוג המוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר עצמו.
product_type_l4	string סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר עצמו.
product_type_l5	string סוג המוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר.
condition	string מצב המוצר.
availability	string זמינות המוצר.
shipping_label	string תווית משלוח מנורמלת שצוינה במקור הנתונים.
item_group_id	string מזהה קבוצת הפריטים שסופק על ידי המוכר כדי לקבץ וריאציות יחד.
thumbnail_link	string קישור לתמונה המעובדת של המוצר, שמתארחת בתשתית של Google.
aggregated_reporting_context_status	AggregatedReportingContextStatus סטטוס מצטבר.
click_potential_rank	int64 דירוג המוצר על סמך פוטנציאל הקליקים שלו. למוצר עם click_potential_rank 1 יש את פוטנציאל הקליקים הגבוה ביותר מבין המוצרים של המוכר שעומדים בתנאים של שאילתת החיפוש.

AggregatedReportingContextStatus

הסטטוס של המוצר המצטבר בכל הקשרי הדיווח.

דוגמה לאופן החישוב של הסטטוס המצטבר:

כרטיסי מוצר חינמיים	מודעות שופינג	סטטוס
אושר	אושר	כשיר
אושר	בהמתנה	כשיר
אושר	נדחה	ELIGIBLE_LIMITED
בהמתנה	בהמתנה	בהמתנה
נדחה	נדחה	NOT_ELIGIBLE_OR_DISAPPROVED

טיפוסים בני מנייה (enums)
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED	לא צוין.
NOT_ELIGIBLE_OR_DISAPPROVED	המוצר לא עומד בדרישות או שנפסל בכל הקשרי הדיווח.
PENDING	סטטוס המוצר הוא 'בהמתנה' בכל הקשרי הדיווח.
ELIGIBLE_LIMITED	המוצר מתאים להקשרי דיווח מסוימים (אבל לא לכולם).
ELIGIBLE	המוצר מתאים לכל הקשרי הדיווח.

ClickPotential

פוטנציאל הקליקים של מוצר הוא אומדן של פוטנציאל הביצועים בהשוואה למוצרים של המוכר בעלי הביצועים הטובים ביותר. פוטנציאל הקליקים של מוצר עוזר למוכרים לתעדף את המוצרים שכדאי לתקן, ועוזר להם להבין את הביצועים של המוצרים ביחס לפוטנציאל שלהם.

טיפוסים בני מנייה (enums)
CLICK_POTENTIAL_UNSPECIFIED	השפעה חזויה לא ידועה של קליקים.
LOW	פוטנציאל לקבלת מספר קליקים נמוך בהשוואה למוצרים של המוֹכר בעלי הביצועים הטובים ביותר.
MEDIUM	פוטנציאל לקבלת מספר קליקים בינוני בהשוואה למוצרים של המוֹכר בעלי הביצועים הטובים ביותר.
HIGH	פוטנציאל לקבלת מספר קליקים דומה לזה של המוצרים של המוֹכר בעלי הביצועים הטובים ביותר.

ItemIssue

בעיה בפריט שמשויכת למוצר.

שדות
type	ItemIssueType סוג הבעיה בפריט.
severity	ItemIssueSeverity חומרת הבעיה בפריט.
resolution	ItemIssueResolution פתרון בעיות בפריט.

ItemIssueResolution

איך פותרים את הבעיה.

טיפוסים בני מנייה (enums)
ITEM_ISSUE_RESOLUTION_UNSPECIFIED	לא צוין.
MERCHANT_ACTION	המוכר צריך לפתור את הבעיה.
PENDING_PROCESSING	הבעיה תיפתר באופן אוטומטי (לדוגמה, סריקת תמונה) או באמצעות בדיקה של Google. לא נדרשת כרגע פעולה למוכרים. הפתרון עלול להוביל לבעיה אחרת (לדוגמה, אם הסריקה נכשלת).

ItemIssueSeverity

איך הבעיה משפיעה על הצגת המוצר.

שדות
severity_per_reporting_context[]	IssueSeverityPerReportingContext חומרת הבעיה לפי הקשר הדיווח.
aggregated_severity	AggregatedIssueSeverity רמת החומרה המצטברת של הבעיה בכל הקשרי הדיווח שהיא משפיעה עליהם. אפשר להשתמש בשדה הזה לסינון התוצאות.

AggregatedIssueSeverity

חומרת הבעיה נצברת לכל הקשרי הדיווח.

טיפוסים בני מנייה (enums)
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED	לא צוין.
DISAPPROVED	בגלל הבעיה, המוצר נפסל בהקשר של דיווח אחד לפחות.
DEMOTED	'בעיה' מורידה את המוצר בדרגה בכל הקשרי הדיווח שעליהם היא משפיעה.
PENDING	הבעיה נפתרה: PENDING_PROCESSING.

IssueSeverityPerReportingContext

חומרת הבעיה לפי הקשר הדיווח.

שדות
disapproved_countries[]	string רשימת המדינות שנדחו בהקשר לדיווח, מיוצגת בפורמט ISO 3166.
demoted_countries[]	string רשימה של מדינות שהורדו בדרגה בהקשר הדיווח, מיוצגת בפורמט ISO 3166.
reporting_context	ReportingContextEnum הקשר הדיווח שהבעיה רלוונטית אליו.

ItemIssueType

סוג הבעיה.

שדות
code	string קוד השגיאה של הבעיה, זהה לקוד code של בעיות במוצרים.
canonical_attribute	string שם מאפיין קנוני לבעיות ספציפיות למאפיין.

RelativeDemand

אין שדות בסוג הזה.

ביקוש יחסי לאשכול מוצרים או למותג בדוח 'המוצרים הכי נמכרים'.

RelativeDemandEnum

ערכי ביקוש יחסיים.

טיפוסים בני מנייה (enums)
RELATIVE_DEMAND_ENUM_UNSPECIFIED	לא צוין.
VERY_LOW	הביקוש הוא 0-5% מהביקוש של אשכול המוצרים או המותג שקיבלו את הדירוג הכי גבוה.
LOW	הביקוש הוא 6-10% מהביקוש של אשכול המוצרים או המותג שקיבלו את הדירוג הכי גבוה.
MEDIUM	הביקוש הוא 11-20% מהביקוש של אשכול המוצרים או המותג שקיבלו את הדירוג הכי גבוה.
HIGH	הביקוש הוא 21-50% מהביקוש של אשכול המוצרים או המותג שקיבלו את הדירוג הכי גבוה.
VERY_HIGH	הביקוש הוא 51-100% מהביקוש של אשכול המוצרים או המותג שקיבלו את הדירוג הכי גבוה.

RelativeDemandChangeType

אין שדות בסוג הזה.

ביקוש יחסי לאשכול מוצרים או למותג בדוח 'המוצרים הכי נמכרים' בהשוואה לתקופת הזמן הקודמת.

RelativeDemandChangeTypeEnum

ערכים יחסיים של סוג שינוי בביקוש.

טיפוסים בני מנייה (enums)
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED	לא צוין.
SINKER	הביקוש היחסי נמוך יותר בהשוואה לתקופה הקודמת.
FLAT	הביקוש היחסי שווה לתקופה הקודמת.
RISER	הביקוש היחסי גבוה יותר בהשוואה לתקופה הקודמת.

ReportGranularity

אין שדות בסוג הזה.

רמת הפירוט של הדוח 'המוצרים הכי נמכרים'. הדוחות 'המוצרים הכי נמכרים' מחושבים במהלך שבוע ומסגרת זמן של חודש.

ReportGranularityEnum

ערכי פירוט של דוח.

טיפוסים בני מנייה (enums)
REPORT_GRANULARITY_ENUM_UNSPECIFIED	לא צוין.
WEEKLY	הדוח מחושב לפי פרק זמן של שבוע.
MONTHLY	הדוח מחושב לפי פרק זמן של חודש.

ReportRow

שורת התוצאה שהוחזרה משאילתת החיפוש.

רק ההודעה שתואמת לטבלת השאילתות תאוכלס בתשובה. בהודעה המאוכלסת, רק השדות שנדרשו במפורש בשאילתה יאוכלסו.

שדות
product_performance_view	ProductPerformanceView השדות הזמינים לשאילתה בטבלה product_performance_view.
non_product_performance_view	NonProductPerformanceView השדות הזמינים לשאילתה בטבלה non_product_performance_view.
product_view	ProductView השדות הזמינים לשאילתה בטבלה product_view.
price_competitiveness_product_view	PriceCompetitivenessProductView השדות הזמינים לשאילתה בטבלה price_competitiveness_product_view.
price_insights_product_view	PriceInsightsProductView השדות הזמינים לשאילתה בטבלה price_insights_product_view.
best_sellers_product_cluster_view	BestSellersProductClusterView השדות הזמינים לשאילתה בטבלה best_sellers_product_cluster_view.
best_sellers_brand_view	BestSellersBrandView השדות הזמינים לשאילתה בטבלה best_sellers_brand_view.
competitive_visibility_competitor_view	CompetitiveVisibilityCompetitorView השדות הזמינים לשאילתה בטבלה competitive_visibility_competitor_view.
competitive_visibility_top_merchant_view	CompetitiveVisibilityTopMerchantView השדות הזמינים לשאילתה בטבלה competitive_visibility_top_merchant_view.
competitive_visibility_benchmark_view	CompetitiveVisibilityBenchmarkView השדות הזמינים לשאילתה בטבלה competitive_visibility_benchmark_view.

SearchRequest

הודעת בקשה ל-method ReportService.Search.

שדות
parent	string חובה. המזהה של החשבון שבאמצעותו התבצע השיחה. החשבון חייב להיות חשבון עצמאי או חשבון משנה של MCA. פורמט: accounts/{account}
query	string חובה. שאילתה שמגדירה דוח לאחזור. כדי ללמוד איך ליצור את השאילתה, תוכלו לעיין במדריך לשפת השאילתות. הרשימה המלאה של הטבלאות והשדות הזמינים מופיעה בשדות הזמינים.
page_size	int32 זה שינוי אופציונלי. מספר ReportRows שצריך לאחזר בדף יחיד. ברירת המחדל היא 1,000. ערכים מעל 5,000 מכווצים ל-5,000.
page_token	string זה שינוי אופציונלי. אסימון הדף שיש לאחזר. אם לא מציינים זאת, מוחזר דף התוצאות הראשון. כדי לבקש את דף התוצאות הבא, יש להשתמש בערך שהתקבל מהפרמטר next_page_token בתגובה הקודמת.

SearchResponse

הודעת תשובה לשיטה ReportService.Search.

שדות
results[]	ReportRow שורות שתאמו לשאילתת החיפוש.
next_page_token	string אסימון שיכול להישלח כ-page_token כדי לאחזר את הדף הבא. אם הוא יושמט, לא יהיו דפים עוקבים.

TrafficSource

אין שדות בסוג הזה.

מקור התנועה של חשיפות בדוח 'חשיפה תחרותית'.

TrafficSourceEnum

הערכים של מקורות התנועה.

טיפוסים בני מנייה (enums)
TRAFFIC_SOURCE_ENUM_UNSPECIFIED	לא צוין.
ORGANIC	תנועה רגילה.
ADS	תנועה ממודעות.
ALL	תנועה אורגנית ותנועה ממודעות.