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 הפופולריות של המותג במודעות ובפלטפורמות אורגניות, בקטגוריה ובמדינה שנבחרו, על סמך המספר המשוער של היחידות שנמכרו.
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 הפופולריות של אשכול המוצרים במודעות ובפלטפורמות אורגניות, בקטגוריה ובמדינה שנבחרו, על סמך המספר המשוער של היחידות שנמכרו.
previous_rank	int64 דירוג הפופולריות בשבוע או בחודש הקודם.
relative_demand	RelativeDemandEnum הביקוש המשוער ביחס לאשכולות המוצרים עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה.
previous_relative_demand	RelativeDemandEnum הביקוש המשוער ביחס לאשכול המוצרים עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה בשבוע או בחודש הקודמים.
relative_demand_change	RelativeDemandChangeTypeEnum שינוי בביקוש המשוער. אם המחיר עלה, ירד או נשאר ללא שינוי.

InventoryStatus

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

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

CompetitiveVisibilityBenchmarkView

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

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

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

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

CompetitiveVisibilityCompetitorView

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

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

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

שדות
date	Date התאריך של השורה הזו. נדרש תנאי על date בפסקה WHERE.
domain	string הדומיין של המתחרה או הדומיין שלכם, אם הערך של 'is_your_domain' הוא true. חובה להוסיף את הערך הזה לפסקה SELECT. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
is_your_domain	bool הערך True אם השורה הזו מכילה נתונים לגבי הדומיין שלכם. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
report_country_code	string המדינה שבה החשיפות הופיעו. חובה להוסיף את הערך הזה לפסקה SELECT. נדרש תנאי על report_country_code בפסקה WHERE.
report_category_id	int64 מזהה קטגוריית המוצר ב-Google שעבורו מחושב הדוח, כפי שהוא מופיע בטקסונומיית המוצרים של Google. חובה להוסיף את הערך הזה לפסקה SELECT. נדרש תנאי על report_category_id בפסקה WHERE.
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. נדרש תנאי על date בפסקה WHERE.
domain	string הדומיין של המתחרה או הדומיין שלכם, אם הערך של 'is_your_domain' הוא true. חובה להוסיף את הערך הזה לפסקה SELECT. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
is_your_domain	bool הערך True אם השורה הזו מכילה נתונים לגבי הדומיין שלכם. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
report_country_code	string המדינה שבה החשיפות הופיעו. חובה להוסיף את הערך הזה לפסקה SELECT. נדרש תנאי על report_country_code בפסקה WHERE.
report_category_id	int64 המזהה של קטגוריית המוצר ב-Google שרוצים לחשב את הדוח, מיוצג בטקסונומיית המוצרים של Google. חובה להזין את הערך הזה בפסקה SELECT. נדרש תנאי על report_category_id בפסקה WHERE.
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

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

טיפוסים בני מנייה (enum)
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 צפויות להוביל לעלייה הגדולה ביותר בביצועים.

טיפוסים בני מנייה (enum)
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.

מוצרים במלאי הנוכחי. המוצרים בטבלה הזו זהים לאלה שב-Product sub-API, אבל לא כל מאפייני המוצרים מ-products משני ה-API זמינים לשאילתה בטבלה הזו. בניגוד ל-Products sub-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. השיטות של 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

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

ClickPotential

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

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

ItemIssue

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

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

ItemIssueResolution

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

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

ItemIssueSeverity

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

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

AggregatedIssueSeverity

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

טיפוסים בני מנייה (enum)
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

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

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

RelativeDemandChangeType

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

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

RelativeDemandChangeTypeEnum

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

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

ReportGranularity

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

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

ReportGranularityEnum

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

טיפוסים בני מנייה (enum)
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

הודעת הבקשה של השיטה 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

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

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