דף זה תורגם על ידי Cloud Translation API.

REST Resource: accounts.reports

משאב: ReportRow
- ייצוג ב-JSON
ProductPerformanceView
- ייצוג ב-JSON
MarketingMethodEnum
NonProductPerformanceView
- ייצוג ב-JSON
ProductView
- ייצוג ב-JSON
AggregatedReportingContextStatus
ItemIssue
- ייצוג ב-JSON
ItemIssueType
- ייצוג ב-JSON
ItemIssueSeverity
- ייצוג ב-JSON
IssueSeverityPerReportingContext
- ייצוג ב-JSON
AggregatedIssueSeverity
ItemIssueResolution
ClickPotential
PriceCompetitivenessProductView
- ייצוג ב-JSON
PriceInsightsProductView
- ייצוג ב-JSON
יעילות
BestSellersProductClusterView
- ייצוג ב-JSON
ReportGranularityEnum
InventoryStatus
RelativeDemandEnum
RelativeDemandChangeTypeEnum
BestSellersBrandView
- ייצוג ב-JSON
CompetitiveVisibilityCompetitorView
- ייצוג ב-JSON
TrafficSourceEnum
CompetitiveVisibilityTopMerchantView
- ייצוג ב-JSON
CompetitiveVisibilityBenchmarkView
- ייצוג ב-JSON
שיטות

משאב: ReportRow

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "productPerformanceView": { object (`ProductPerformanceView`) }, "nonProductPerformanceView": { object (`NonProductPerformanceView`) }, "productView": { object (`ProductView`) }, "priceCompetitivenessProductView": { object (`PriceCompetitivenessProductView`) }, "priceInsightsProductView": { object (`PriceInsightsProductView`) }, "bestSellersProductClusterView": { object (`BestSellersProductClusterView`) }, "bestSellersBrandView": { object (`BestSellersBrandView`) }, "competitiveVisibilityCompetitorView": { object (`CompetitiveVisibilityCompetitorView`) }, "competitiveVisibilityTopMerchantView": { object (`CompetitiveVisibilityTopMerchantView`) }, "competitiveVisibilityBenchmarkView": { object (`CompetitiveVisibilityBenchmarkView`) } }

{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}

שדות
`productPerformanceView`	`object (ProductPerformanceView)` השדות שזמינים לשאילתה בטבלה `productPerformanceView`.
`nonProductPerformanceView`	`object (NonProductPerformanceView)` השדות שזמינים לשאילתה בטבלה `nonProductPerformanceView`.
`productView`	`object (ProductView)` השדות שזמינים לשאילתה בטבלה `productView`.
`priceCompetitivenessProductView`	`object (PriceCompetitivenessProductView)` השדות שזמינים לשאילתה בטבלה `priceCompetitivenessProductView`.
`priceInsightsProductView`	`object (PriceInsightsProductView)` השדות שזמינים לשאילתה בטבלה `priceInsightsProductView`.
`bestSellersProductClusterView`	`object (BestSellersProductClusterView)` השדות שזמינים לשאילתה בטבלה `bestSellersProductClusterView`.
`bestSellersBrandView`	`object (BestSellersBrandView)` השדות שזמינים לשאילתה בטבלה `bestSellersBrandView`.
`competitiveVisibilityCompetitorView`	`object (CompetitiveVisibilityCompetitorView)` השדות שזמינים לשאילתה בטבלה `competitiveVisibilityCompetitorView`.
`competitiveVisibilityTopMerchantView`	`object (CompetitiveVisibilityTopMerchantView)` השדות שזמינים לשאילתה בטבלה `competitiveVisibilityTopMerchantView`.
`competitiveVisibilityBenchmarkView`	`object (CompetitiveVisibilityBenchmarkView)` השדות שזמינים לשאילתה בטבלה `competitiveVisibilityBenchmarkView`.

ProductPerformanceView

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

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

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "date": { object (`Date`) }, "week": { object (`Date`) }, "conversionValue": { object (`Price`) }, "marketingMethod": enum (`MarketingMethodEnum`), "customerCountryCode": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "customLabel0": string, "customLabel1": string, "customLabel2": string, "customLabel3": string, "customLabel4": string, "clicks": string, "impressions": string, "clickThroughRate": number, "conversions": number, "conversionRate": number }

{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}

שדות
`date`	`object (Date)` התאריך לפי אזור הזמן של המוכר שאליו חלים המדדים. פילוח. תנאי על `date` נדרש בפסקה `WHERE`.
`week`	`object (Date)` היום הראשון בשבוע (שני) של תאריך המדדים לפי אזור הזמן של המוכר. פילוח.
`conversionValue`	`object (Price)` הערך של ההמרות שמשויכות למוצר, שדווח בתאריך ההמרה. מדד. הנתונים האלה זמינים רק לגבי מקור התנועה `FREE`.
`marketingMethod`	`enum (MarketingMethodEnum)` שיטת השיווק שאליה חלים המדדים. פילוח.
`customerCountryCode`	`string` הקוד של המדינה שבה הלקוח נמצא בזמן האירוע. מיוצג בפורמט ISO 3166. פילוח. אם לא ניתן לקבוע את מדינה הלקוח, המערכת מחזירה את הקוד המיוחד 'ZZ'.
`offerId`	`string` המזהה של המוצר שסופק על ידי המוכר. פילוח.
`title`	`string` שם המוצר. פילוח.
`brand`	`string` המותג של המוצר. פילוח.
`categoryL1`	`string` קטגוריית מוצרים (רמה ראשונה) בטקסונומיית המוצרים של Google. פילוח.
`categoryL2`	`string` קטגוריית מוצרים (רמה שנייה) בטקסונומיית המוצרים של Google. פילוח.
`categoryL3`	`string` קטגוריית מוצרים (רמה שלישית) בטקסונומיית המוצרים של Google. פילוח.
`categoryL4`	`string` קטגוריית מוצרים (רמה רביעית) בטקסונומיית המוצרים של Google. פילוח.
`categoryL5`	`string` קטגוריית מוצרים (רמה חמישית) בטקסונומיית המוצרים של Google. פילוח.
`productTypeL1`	`string` סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר. פילוח.
`productTypeL2`	`string` סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר. פילוח.
`productTypeL3`	`string` סוג מוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר. פילוח.
`productTypeL4`	`string` סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר. פילוח.
`productTypeL5`	`string` סוג המוצר (רמה חמישית) בתחמונומיית המוצרים של המוכר. פילוח.
`customLabel0`	`string` תווית מותאמת אישית 0 לצורך קיבוץ מותאם אישית של מוצרים. פילוח.
`customLabel1`	`string` תווית מותאמת אישית 1 לקבוצות מותאמות אישית של מוצרים. פילוח.
`customLabel2`	`string` תווית מותאמת אישית 2 לצורך קיבוץ מותאם אישית של מוצרים. פילוח.
`customLabel3`	`string` תווית מותאמת אישית 3 לקבוצות מותאמות אישית של מוצרים. פילוח.
`customLabel4`	`string` תווית מותאמת אישית 4 לצורך קיבוץ מותאם אישית של מוצרים. פילוח.
`clicks`	`string (int64 format)` מספר הקליקים. מדד.
`impressions`	`string (int64 format)` מספר הפעמים שבהן מוצרים של המוכר הוצגו. מדד.
`clickThroughRate`	`number` שיעור קליקים – מספר הקליקים שמקבלים המוצרים של המוכר (קליקים) חלקי מספר הפעמים שהמוצרים מוצגים (חשיפות). מדד.
`conversions`	`number` מספר ההמרות שמשויכות למוצר, שמדווחות בתאריך ההמרה. בהתאם למודל השיוך, יכול להיות שההמרה תופץ בין כמה קליקים, כאשר לכל קליק יוקצה קרדיט משלו. המדד הזה הוא הסכום של כל הזיכויים האלה. מדד. הנתונים האלה זמינים רק לגבי מקור התנועה `FREE`.
`conversionRate`	`number` מספר ההמרות חלקי מספר הקליקים, שדווחו בתאריך החשיפות. מדד. הנתונים האלה זמינים רק לגבי מקור התנועה `FREE`.

MarketingMethodEnum

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

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

NonProductPerformanceView

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

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

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

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

ייצוג ב-JSON
{ "date": { object (`Date`) }, "week": { object (`Date`) }, "clicks": string, "impressions": string, "clickThroughRate": number }

שדות
`date`	`object (Date)` התאריך לפי אזור הזמן של המוכר שאליו חלים המדדים. פילוח. תנאי על `date` נדרש בפסקה `WHERE`.
`week`	`object (Date)` היום הראשון בשבוע (שני) של תאריך המדדים לפי אזור הזמן של המוכר. פילוח.
`clicks`	`string (int64 format)` מספר הקליקים על תמונות ועל קישורים לחנות הווירטואלית שמובילים לדפים שאין בהם מוצרים. מדד.
`impressions`	`string (int64 format)` מספר הפעמים שהוצגו תמונות וקישורים לחנות הווירטואלית שמובילים לדפים באתר שהם לא דפי מוצרים. מדד.
`clickThroughRate`	`number` שיעור קליקים – מספר הקליקים (`clicks`) חלקי מספר החשיפות (`impressions`) של תמונות וקישורים לחנות הווירטואלית שמובילים לדפים שהם לא דפי מוצרים. מדד.

ProductView

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

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "price": { object (`Price`) }, "gtin": [ string ], "creationTime": string, "expirationDate": { object (`Date`) }, "itemIssues": [ { object (`ItemIssue`) } ], "clickPotential": enum (`ClickPotential`), "id": string, "channel": enum (`ChannelEnum`), "languageCode": string, "feedLabel": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "condition": string, "availability": string, "shippingLabel": string, "itemGroupId": string, "thumbnailLink": string, "aggregatedReportingContextStatus": enum (`AggregatedReportingContextStatus`), "clickPotentialRank": string }

{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}

שדות
`price`	`object (Price)` מחיר המוצר. לא מופיע אם המידע על מחיר המוצר לא זמין.
`gtin[]`	`string` רשימה של מספרי הפריט המסחרי הגלובלי (GTIN) של המוצר.
`creationTime`	`string (Timestamp format)` השעה שבה המוכר יצר את המוצר, בשניות של חותמת הזמן.
`expirationDate`	`object (Date)` תאריך התפוגה של המוצר, שצוין בזמן ההוספה.
`itemIssues[]`	`object (ItemIssue)` רשימת הבעיות בפריטים של המוצר. לא ניתן להשתמש בשדה הזה למיון התוצאות. אפשר להשתמש רק במאפיינים נבחרים של השדה הזה (לדוגמה, `itemIssues.severity.aggregated_severity`) כדי לסנן את התוצאות.
`clickPotential`	`enum (ClickPotential)` אומדן פוטנציאל הביצועים בהשוואה למוצרים של המוכר עם הביצועים הטובים ביותר.
`id`	`string` מזהה ה-REST של המוצר, בפורמט `channel~languageCode~feedLabel~offerId`. שיטות של Merchant API שפועלות על מוצרים משתמשות בזה כפרמטר `name`. חובה להוסיף את הערך הזה לפסקה `SELECT`.
`channel`	`enum (ChannelEnum)` הערוץ של המוצר. הערך יכול להיות `ONLINE` או `LOCAL`.
`languageCode`	`string` קוד השפה של המוצר בפורמט BCP 47.
`feedLabel`	`string` תווית הפיד של המוצר.
`offerId`	`string` המזהה של המוצר שסופק על ידי המוכר.
`title`	`string` שם המוצר.
`brand`	`string` המותג של המוצר.
`categoryL1`	`string` קטגוריית מוצרים (רמה ראשונה) בטקסונומיית המוצרים של Google.
`categoryL2`	`string` קטגוריית מוצרים (רמה שנייה) בטקסונומיית המוצרים של Google.
`categoryL3`	`string` קטגוריית מוצרים (רמה שלישית) בטקסונומיית המוצרים של Google.
`categoryL4`	`string` קטגוריית מוצרים (רמה רביעית) בטקסונומיית המוצרים של Google.
`categoryL5`	`string` קטגוריית מוצרים (רמה חמישית) בטקסונומיית המוצרים של Google.
`productTypeL1`	`string` סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר.
`productTypeL2`	`string` סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר.
`productTypeL3`	`string` סוג המוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר.
`productTypeL4`	`string` סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר.
`productTypeL5`	`string` סוג המוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר.
`condition`	`string` מצב המוצר.
`availability`	`string` הזמינות של המוצר.
`shippingLabel`	`string` תווית משלוח מנורמלת שצוינה במקור הנתונים.
`itemGroupId`	`string` מזהה קבוצת פריטים שסופק על ידי המוכר לצורך קיבוץ וריאציות.
`thumbnailLink`	`string` קישור לתמונה המעובדת של המוצר, שמתארח בתשתית של Google.
`aggregatedReportingContextStatus`	`enum (AggregatedReportingContextStatus)` סטטוס מצטבר.
`clickPotentialRank`	`string (int64 format)` הדירוג של המוצר על סמך פוטנציאל הקליקים שלו. למוצר עם הערך `clickPotentialRank` 1 יש את פוטנציאל הקליקים הגבוה ביותר מבין המוצרים של המוכר שעומדים בתנאי שאילתת החיפוש.

AggregatedReportingContextStatus

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

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

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

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

ItemIssue

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

ייצוג ב-JSON
{ "type": { object (`ItemIssueType`) }, "severity": { object (`ItemIssueSeverity`) }, "resolution": enum (`ItemIssueResolution`) }

שדות

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

type

object (ItemIssueType)

סוג הבעיה בפריט.

severity

object (ItemIssueSeverity)

חומרת הבעיה בפריט.

resolution

enum (ItemIssueResolution)

פתרון הבעיה בפריט.

ItemIssueType

סוג הבעיה.

ייצוג ב-JSON
{ "code": string, "canonicalAttribute": string }

שדות

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

code

string

קוד השגיאה של הבעיה, שזהה ל-code בקטע בעיות במוצרים.

canonicalAttribute

string

השם הרשמי של המאפיין לבעיות ספציפיות למאפיין.

ItemIssueSeverity

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

ייצוג ב-JSON
{ "severityPerReportingContext": [ { object (`IssueSeverityPerReportingContext`) } ], "aggregatedSeverity": enum (`AggregatedIssueSeverity`) }

שדות

שדות
`severityPerReportingContext[]`	`object (IssueSeverityPerReportingContext)` חומרת הבעיה לפי הקשר הדיווח.
`aggregatedSeverity`	`enum (AggregatedIssueSeverity)` חומרת הבעיה המצטברת בכל ההקשרים של הדיווח שהיא משפיעה עליהם. אפשר להשתמש בשדה הזה כדי לסנן את התוצאות.

severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

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

aggregatedSeverity

enum (AggregatedIssueSeverity)

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

אפשר להשתמש בשדה הזה כדי לסנן את התוצאות.

IssueSeverityPerReportingContext

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

ייצוג ב-JSON
{ "disapprovedCountries": [ string ], "demotedCountries": [ string ], "reportingContext": enum (`ReportingContextEnum`) }

שדות

שדות
`disapprovedCountries[]`	`string` רשימת המדינות שנדחו בהקשר הדיווח, שמוצגות בפורמט ISO 3166.
`demotedCountries[]`	`string` רשימה של מדינות שהורדנו לרמה נמוכה יותר בהקשר הדיווח, שמוצגות בפורמט ISO 3166.
`reportingContext`	`enum (ReportingContextEnum)` ההקשר של הדיווח שאליו רלוונטית הבעיה.

disapprovedCountries[]

string

רשימת המדינות שנדחו בהקשר הדיווח, שמוצגות בפורמט ISO 3166.

demotedCountries[]

string

רשימה של מדינות שהורדנו לרמה נמוכה יותר בהקשר הדיווח, שמוצגות בפורמט ISO 3166.

reportingContext

enum (ReportingContextEnum)

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

AggregatedIssueSeverity

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

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

ItemIssueResolution

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

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

ClickPotential

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

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

PriceCompetitivenessProductView

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

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "price": { object (`Price`) }, "benchmarkPrice": { object (`Price`) }, "reportCountryCode": string, "id": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string }

{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}

שדות
`price`	`object (Price)` המחיר הנוכחי של המוצר.
`benchmarkPrice`	`object (Price)` המחיר הנוכחי המקובל בשוק של הקטלוג של המוצר במדינה שבה נערך הבדיקת השוואת המחירים.
`reportCountryCode`	`string` המדינה של התמחור בתעשייה. מיוצג בפורמט ISO 3166. חובה להוסיף את הערך הזה לפסקה `SELECT`.
`id`	`string` מזהה ה-REST של המוצר, בפורמט `channel~languageCode~feedLabel~offerId`. אפשר להשתמש בה כדי לצרף נתונים לטבלה `productView`. חובה להוסיף את הערך הזה לפסקה `SELECT`.
`offerId`	`string` המזהה של המוצר שסופק על ידי המוכר.
`title`	`string` שם המוצר.
`brand`	`string` המותג של המוצר.
`categoryL1`	`string` קטגוריית מוצרים (רמה ראשונה) בטקסונומיית המוצרים של Google.
`categoryL2`	`string` קטגוריית מוצרים (רמה שנייה) בטקסונומיית המוצרים של Google.
`categoryL3`	`string` קטגוריית מוצרים (רמה שלישית) בטקסונומיית המוצרים של Google.
`categoryL4`	`string` קטגוריית מוצרים (רמה רביעית) בטקסונומיית המוצרים של Google.
`categoryL5`	`string` קטגוריית מוצרים (רמה חמישית) בטקסונומיית המוצרים של Google.
`productTypeL1`	`string` סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר.
`productTypeL2`	`string` סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר.
`productTypeL3`	`string` סוג המוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר.
`productTypeL4`	`string` סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר.
`productTypeL5`	`string` סוג המוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר.

PriceInsightsProductView

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

הדוח מדדי מחירים.

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "price": { object (`Price`) }, "suggestedPrice": { object (`Price`) }, "effectiveness": enum (`Effectiveness`), "id": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "predictedImpressionsChangeFraction": number, "predictedClicksChangeFraction": number, "predictedConversionsChangeFraction": number }

{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}

שדות
`price`	`object (Price)` המחיר הנוכחי של המוצר.
`suggestedPrice`	`object (Price)` המחיר המוצע העדכני ביותר למוצר.
`effectiveness`	`enum (Effectiveness)` היעילות הצפויה של יישום המחיר המומלץ, לפי קטגוריות.
`id`	`string` מזהה ה-REST של המוצר, בפורמט `channel~languageCode~feedLabel~offerId`. אפשר להשתמש בה כדי לצרף נתונים לטבלה `productView`. חובה להוסיף את הערך הזה לפסקה `SELECT`.
`offerId`	`string` המזהה של המוצר שסופק על ידי המוכר.
`title`	`string` שם המוצר.
`brand`	`string` המותג של המוצר.
`categoryL1`	`string` קטגוריית מוצרים (רמה ראשונה) בטקסונומיית המוצרים של Google.
`categoryL2`	`string` קטגוריית מוצרים (רמה שנייה) בטקסונומיית המוצרים של Google.
`categoryL3`	`string` קטגוריית מוצרים (רמה שלישית) בטקסונומיית המוצרים של Google.
`categoryL4`	`string` קטגוריית מוצרים (רמה רביעית) בטקסונומיית המוצרים של Google.
`categoryL5`	`string` קטגוריית מוצרים (רמה חמישית) בטקסונומיית המוצרים של Google.
`productTypeL1`	`string` סוג המוצר (רמה ראשונה) בטקסונומיית המוצרים של המוכר.
`productTypeL2`	`string` סוג המוצר (רמה שנייה) בטקסונומיית המוצרים של המוכר.
`productTypeL3`	`string` סוג המוצר (רמה שלישית) בטקסונומיית המוצרים של המוכר.
`productTypeL4`	`string` סוג המוצר (רמה רביעית) בטקסונומיית המוצרים של המוכר.
`productTypeL5`	`string` סוג המוצר (רמה חמישית) בטקסונומיית המוצרים של המוכר.
`predictedImpressionsChangeFraction`	`number` השינוי הצפוי במספר החשיפות כחלק אחרי הצגת המחיר המומלץ בהשוואה למחיר הפעיל הנוכחי. לדוגמה, הערך 0.05 מייצג עלייה צפויה של 5% במספר החשיפות.
`predictedClicksChangeFraction`	`number` השינוי הצפוי במספר הקליקים כחלק אחרי הצגת המחיר המומלץ בהשוואה למחיר הפעיל הנוכחי. לדוגמה, הערך 0.05 מייצג עלייה צפויה של 5% במספר הקליקים.
`predictedConversionsChangeFraction`	`number` השינוי הצפוי במספר ההמרות כחלק אחרי הצגת המחיר המומלץ, בהשוואה למחיר הפעיל הנוכחי. לדוגמה, הערך 0.05 מייצג עלייה צפויה של 5% במספר ההמרות).

יעילות

הקטגוריה של מידת האפקטיביות הצפויה.

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

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

BestSellersProductClusterView

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

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "reportDate": { object (`Date`) }, "variantGtins": [ string ], "reportGranularity": enum (`ReportGranularityEnum`), "reportCountryCode": string, "reportCategoryId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "inventoryStatus": enum (`InventoryStatus`), "brandInventoryStatus": enum (`InventoryStatus`), "rank": string, "previousRank": string, "relativeDemand": enum (`RelativeDemandEnum`), "previousRelativeDemand": enum (`RelativeDemandEnum`), "relativeDemandChange": enum (`RelativeDemandChangeTypeEnum`) }

{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}

שדות
`reportDate`	`object (Date)` תאריך הדוח. הערך בשדה הזה יכול להיות רק אחד מהערכים הבאים: היום הראשון בשבוע (יום שני) לדוחות שבועיים, היום הראשון בחודש עבור דוחות חודשיים. חובה להוסיף את הערך הזה לפסקה `SELECT`. אם לא צוין ב-query תנאי `WHERE` ב-`reportDate`, יופיע הדוח השבועי או החודשי העדכני ביותר.
`variantGtins[]`	`string` מספרי GTIN של וריאציות לדוגמה של אשכול המוצרים.
`reportGranularity`	`enum (ReportGranularityEnum)` רמת הפירוט של הדוח. אפשר לבצע את הדירוג במסגרת זמן של שבוע או חודש. חובה להוסיף את הערך הזה לפסקה `SELECT`. תנאי על `reportGranularity` נדרש בפסקה `WHERE`.
`reportCountryCode`	`string` המדינה שבה מחושב הדירוג. מיוצג בפורמט ISO 3166. חובה להוסיף את הערך הזה לפסקה `SELECT`. תנאי על `reportCountryCode` נדרש בפסקה `WHERE`.
`reportCategoryId`	`string (int64 format)` מזהה קטגוריית המוצר ב-Google שעבורו מחושב הדירוג, כפי שהוא מופיע בטקסונומיית המוצרים של Google. חובה להוסיף את הערך הזה לפסקה `SELECT`. אם לא צוין תנאי `WHERE` ב-`reportCategoryId` בשאילתה, יוחזרו דירוגים של כל הקטגוריות ברמה העליונה.
`title`	`string` השם של אשכול המוצרים.
`brand`	`string` המותג של אשכול המוצרים.
`categoryL1`	`string` קטגוריית המוצרים (רמה ראשונה) של אשכול המוצרים, שמיוצגת בטקסונומיית המוצרים של Google.
`categoryL2`	`string` קטגוריית המוצרים (רמה שנייה) של אשכול המוצרים, שמיוצגת בטקסונומיית המוצרים של Google.
`categoryL3`	`string` קטגוריית המוצרים (רמה שלישית) של אשכול המוצרים, שמיוצגת בטקסונומיית המוצרים של Google.
`categoryL4`	`string` קטגוריית המוצרים (רמה רביעית) של אשכול המוצרים, שמיוצגת בטקסונומיית המוצרים של Google.
`categoryL5`	`string` קטגוריית המוצרים (רמה חמישית) של אשכול המוצרים, שמיוצגת בטקסונומיית המוצרים של Google.
`inventoryStatus`	`enum (InventoryStatus)` האם אשכול המוצרים הוא `IN_STOCK` במקור נתוני המוצרים במדינה אחת לפחות, `OUT_OF_STOCK` במקור נתוני המוצרים בכל המדינות או `NOT_IN_INVENTORY` בכלל. השדה לא מביא בחשבון את מסנן המדינות בדוח 'המוצרים הכי נמכרים'.
`brandInventoryStatus`	`enum (InventoryStatus)` האם יש לפחות מוצר אחד של המותג שסטטוס הזמינות שלו הוא `IN_STOCK` במקור נתוני המוצרים שלכם לפחות באחת מהמדינות, האם כל המוצרים בסטטוס `OUT_OF_STOCK` במקור נתוני המוצרים שלכם בכל המדינות, או `NOT_IN_INVENTORY`. השדה לא מביא בחשבון את מסנן המדינות בדוח 'המוצרים הכי נמכרים'.
`rank`	`string (int64 format)` הפופולריות של אשכול המוצרים במודעות ובפלטפורמות אורגניות, בקטגוריה ובמדינה שנבחרו, על סמך המספר המשוער של היחידות שנמכרו.
`previousRank`	`string (int64 format)` דירוג הפופולריות בשבוע או בחודש הקודם.
`relativeDemand`	`enum (RelativeDemandEnum)` הביקוש המשוער ביחס לאשכולות המוצרים עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה.
`previousRelativeDemand`	`enum (RelativeDemandEnum)` הביקוש המשוער ביחס לאשכולות המוצרים עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה בשבוע או בחודש הקודם.
`relativeDemandChange`	`enum (RelativeDemandChangeTypeEnum)` שינוי בביקוש המשוער. אם המחיר עלה, ירד או נשאר ללא שינוי.

ReportGranularityEnum

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

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

InventoryStatus

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

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

RelativeDemandEnum

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

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

RelativeDemandChangeTypeEnum

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

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

BestSellersBrandView

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

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "reportDate": { object (`Date`) }, "reportGranularity": enum (`ReportGranularityEnum`), "reportCountryCode": string, "reportCategoryId": string, "brand": string, "rank": string, "previousRank": string, "relativeDemand": enum (`RelativeDemandEnum`), "previousRelativeDemand": enum (`RelativeDemandEnum`), "relativeDemandChange": enum (`RelativeDemandChangeTypeEnum`) }

{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}

שדות
`reportDate`	`object (Date)` תאריך הדוח. הערך בשדה הזה יכול להיות רק אחד מהערכים הבאים: היום הראשון בשבוע (יום שני) לדוחות שבועיים, היום הראשון בחודש עבור דוחות חודשיים. חובה להוסיף את הערך הזה לפסקה `SELECT`. אם לא צוין ב-query תנאי `WHERE` ב-`reportDate`, יופיע הדוח השבועי או החודשי העדכני ביותר.
`reportGranularity`	`enum (ReportGranularityEnum)` רמת הפירוט של הדוח. אפשר לבצע את הדירוג במסגרת זמן של שבוע או חודש. חובה להוסיף את הערך הזה לפסקה `SELECT`. תנאי על `reportGranularity` נדרש בפסקה `WHERE`.
`reportCountryCode`	`string` המדינה שבה מחושב הדירוג. מיוצג בפורמט ISO 3166. חובה להוסיף את הערך הזה לפסקה `SELECT`. תנאי על `reportCountryCode` נדרש בפסקה `WHERE`.
`reportCategoryId`	`string (int64 format)` מזהה קטגוריית המוצר ב-Google שעבורו מחושב הדירוג, כפי שהוא מופיע בטקסונומיית המוצרים של Google. חובה להוסיף את הערך הזה לפסקה `SELECT`. אם לא צוין תנאי `WHERE` ב-`reportCategoryId` בשאילתה, יוחזרו דירוגים של כל הקטגוריות ברמה העליונה.
`brand`	`string` שם המותג.
`rank`	`string (int64 format)` הפופולריות של המותג במודעות ובפלטפורמות אורגניות, בקטגוריה ובמדינה שנבחרו, על סמך המספר המשוער של היחידות שנמכרו.
`previousRank`	`string (int64 format)` דירוג הפופולריות בשבוע או בחודש הקודם.
`relativeDemand`	`enum (RelativeDemandEnum)` הביקוש המשוער ביחס למותג עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה.
`previousRelativeDemand`	`enum (RelativeDemandEnum)` הביקוש המשוער ביחס למותג עם דירוג הפופולריות הגבוה ביותר באותה קטגוריה ובאותה מדינה בשבוע או בחודש הקודם.
`relativeDemandChange`	`enum (RelativeDemandChangeTypeEnum)` שינוי בביקוש המשוער. אם המחיר עלה, ירד או נשאר ללא שינוי.

CompetitiveVisibilityCompetitorView

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

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "date": { object (`Date`) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`TrafficSourceEnum`), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number, "relativeVisibility": number }

{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}

שדות
`date`	`object (Date)` התאריך של השורה הזו. נדרש תנאי על `date` בפסקה `WHERE`.
`domain`	`string` הדומיין של המתחרה או הדומיין שלכם, אם הערך של 'isYourDomain' הוא true. חובה להוסיף את הערך הזה לפסקה `SELECT`. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`isYourDomain`	`boolean` הערך True אם השורה הזו מכילה נתונים לגבי הדומיין שלכם. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`reportCountryCode`	`string` המדינה שבה החשיפות הופיעו. חובה להוסיף את הערך הזה לפסקה `SELECT`. נדרש תנאי על `reportCountryCode` בפסקה `WHERE`.
`reportCategoryId`	`string (int64 format)` מזהה קטגוריית המוצר ב-Google שעבורו מחושב הדוח, כפי שהוא מופיע בטקסונומיית המוצרים של Google. חובה להוסיף את הערך הזה לפסקה `SELECT`. נדרש תנאי על `reportCategoryId` בפסקה `WHERE`.
`trafficSource`	`enum (TrafficSourceEnum)` מקור התנועה של החשיפות. חובה להוסיף את הערך הזה לפסקה `SELECT`.
`rank`	`string (int64 format)` המיקום של הדומיין בדירוג העסקים הדומים למפתחות שנבחרו (`date`, ‏ `reportCategoryId`, ‏ `reportCountryCode`, ‏ `trafficSource`) על סמך חשיפות. הערך 1 הוא הגבוה ביותר. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`adsOrganicRatio`	`number` המדד יחס מודעות / חיפוש אורגני מראה באיזו תדירות הדומיין מקבל חשיפות ממודעות שופינג בהשוואה לתנועה אורגנית. המספר יעוגל ויוקצה לקטגוריה. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`pageOverlapRate`	`number` שיעור החפיפה בדף מתייחס לתדירות שבה המוצרים של קמעונאים מתחרים מוצגים יחד עם המוצרים שלכם באותו דף. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`higherPositionRate`	`number` המדד שיעור מיקום גבוה יותר מראה באיזו תדירות מוצר של מתחרה הופיע בדף החיפוש במיקום גבוה יותר מזה של המוצר שלכם. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`relativeVisibility`	`number` המדד חשיפה יחסית מראה באיזו תדירות המוצרים של המתחרים שלכם מוצגים בהשוואה למוצרים שלכם. במילים אחרות, זהו מספר החשיפות של המוצרים של קמעונאי מתחרה חלקי מספר החשיפות של המוצרים שלכם בטווח הזמן, בקטגוריית המוצרים ובמדינה שבחרתם. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.

TrafficSourceEnum

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

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

CompetitiveVisibilityTopMerchantView

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

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "date": { object (`Date`) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`TrafficSourceEnum`), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number }

{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}

שדות
`date`	`object (Date)` התאריך של השורה הזו. לא ניתן לבחור אותו בפסקה `SELECT`. נדרש תנאי על `date` בפסקה `WHERE`.
`domain`	`string` הדומיין של המתחרה או הדומיין שלכם, אם הערך של 'isYourDomain' הוא true. חובה להוסיף את הערך הזה לפסקה `SELECT`. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`isYourDomain`	`boolean` הערך True אם השורה הזו מכילה נתונים לגבי הדומיין שלכם. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`reportCountryCode`	`string` המדינה שבה החשיפות הופיעו. חובה להוסיף את הערך הזה לפסקה `SELECT`. נדרש תנאי על `reportCountryCode` בפסקה `WHERE`.
`reportCategoryId`	`string (int64 format)` מזהה קטגוריית המוצר ב-Google שעבורו מחושב הדוח, כפי שהוא מופיע בטקסונומיית המוצרים של Google. חובה להוסיף את הערך הזה לפסקה `SELECT`. נדרש תנאי על `reportCategoryId` בפסקה `WHERE`.
`trafficSource`	`enum (TrafficSourceEnum)` מקור התנועה של החשיפות. חובה להוסיף את הערך הזה לפסקה `SELECT`.
`rank`	`string (int64 format)` המיקום של הדומיין בדירוג המוכרים המובילים למפתחות שנבחרו (`date`, ‏ `reportCategoryId`, ‏ `reportCountryCode`, ‏ `trafficSource`) על סמך חשיפות. הערך 1 הוא הגבוה ביותר. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`adsOrganicRatio`	`number` המדד יחס מודעות / חיפוש אורגני מראה באיזו תדירות הדומיין מקבל חשיפות ממודעות שופינג בהשוואה לתנועה אורגנית. המספר יעוגל ויוקצה לקטגוריה. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`pageOverlapRate`	`number` שיעור החפיפה בדף מתייחס לתדירות שבה המוצרים של קמעונאים מתחרים מוצגים יחד עם המוצרים שלכם באותו דף. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`higherPositionRate`	`number` המדד שיעור מיקום גבוה יותר מראה באיזו תדירות מוצר של מתחרה הופיע בדף החיפוש במיקום גבוה יותר מזה של המוצר שלכם. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.

CompetitiveVisibilityBenchmarkView

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

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "date": { object (`Date`) }, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`TrafficSourceEnum`), "yourDomainVisibilityTrend": number, "categoryBenchmarkVisibilityTrend": number }

{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}

שדות
`date`	`object (Date)` התאריך של השורה הזו. חובה להוסיף את הערך הזה לפסקה `SELECT`. נדרש תנאי על `date` בפסקה `WHERE`.
`reportCountryCode`	`string` המדינה שבה החשיפות הופיעו. חובה להוסיף את הערך הזה לפסקה `SELECT`. נדרש תנאי על `reportCountryCode` בפסקה `WHERE`.
`reportCategoryId`	`string (int64 format)` מזהה קטגוריית המוצר ב-Google שעבורו מחושב הדוח, כפי שהוא מופיע בטקסונומיית המוצרים של Google. חובה להוסיף את הערך הזה לפסקה `SELECT`. נדרש תנאי על `reportCategoryId` בפסקה `WHERE`.
`trafficSource`	`enum (TrafficSourceEnum)` מקור התנועה של החשיפות. חובה להוסיף את הערך הזה לפסקה `SELECT`.
`yourDomainVisibilityTrend`	`number` שינוי בחשיפה על סמך חשיפות בדומיין ביחס לתחילת טווח הזמן שנבחר (או היום הראשון עם חשיפות שאינן אפס). לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.
`categoryBenchmarkVisibilityTrend`	`number` שינוי בחשיפה על סמך חשיפות ביחס לתחילת טווח הזמן שנבחר (או היום הראשון עם חשיפות שאינן אפס) עבור קבוצה משולבת של מוכרים עם החשיפה הגבוהה ביותר, שמשקפת את השוק. לא ניתן לסנן לפי השדה הזה בפסקה 'WHERE'.

Methods
`search`	אחזור דוח שמוגדר על ידי שאילתת חיפוש.

REST Resource: accounts.reports

משאב: ReportRow

ProductPerformanceView

MarketingMethodEnum

NonProductPerformanceView

ProductView

AggregatedReportingContextStatus

ItemIssue

ItemIssueType

ItemIssueSeverity

IssueSeverityPerReportingContext

AggregatedIssueSeverity

ItemIssueResolution

ClickPotential

PriceCompetitivenessProductView

PriceInsightsProductView

יעילות

BestSellersProductClusterView

ReportGranularityEnum

InventoryStatus

RelativeDemandEnum

RelativeDemandChangeTypeEnum

BestSellersBrandView

CompetitiveVisibilityCompetitorView

TrafficSourceEnum

CompetitiveVisibilityTopMerchantView

CompetitiveVisibilityBenchmarkView

Methods

search

`search`