השירות של Merchant API v1beta‎ יופסק וייצא משימוש ב-28 בפברואר 2026. הוראות למעבר לגרסה היציבה העדכנית זמינות במאמר מעבר מגרסה v1beta לגרסה v1.

הערך את המוצרים שלך

אתם יכולים להשתמש ב-Merchant Reports API כדי לצפות בנתוני ביצועים, לסנן את המוצרים לפי מאפיינים ספציפיים ולשפר את התמחור.

למדוד ביצועים

אתם יכולים לאחזר מדדי ביצועים של החשבון באמצעות Merchant Reports API‏ product_performance_view.

דרישות

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

כדי להקצות את התפקיד 'ביצועים ותובנות' למשתמש קיים, יוצרים בקשת תיקון ומקצים למשתמש את זכות הגישה PERFORMANCE_REPORTING. בדוגמה הבאה מוצגת בקשת תיקון להקצאת זכות הגישה PERFORMANCE_REPORTING:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

מחליפים את מה שכתוב בשדות הבאים:

‫{ACCOUNT_ID}: המזהה הייחודי של חשבון Merchant Center.
‫{EMAIL_ID}: כתובת האימייל של המשתמש שרוצים להקצות לו את התפקיד.

דוגמה לשאילתה

השאילתה הבאה מאחזרת את הערכים impressions, clicks ו-click_through_rate לכל המוצרים בחשבון שלכם במהלך תקופה ספציפית של 30 יום. כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה של Merchant Center Query Language אל השיטה accounts.reports.search:

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

מידע נוסף על דוחות ביצועים זמין במדריך בנושא דוחות ביצועים.

סינון מוצרים

אפשר להשתמש ב-Merchant Reports API‏ product_view כדי להציג תצוגה מסוננת של נתוני המוצרים, כולל סטטוסי המוצרים. לדוגמה, אפשר להשתמש בשאילתה product_view כדי לקבל רשימה של מוצרים שיש בהם בעיות, או כדי לקבל רשימה של המוצרים החדשים שלכם ולאמת את ההצגה שלהם.

חובה לכלול את השדה id בסעיף SELECT של השאילתה. הערך של id זהה לערך של מזהה REST של המוצר.

אפשר לסנן לפי כל השדות הזמינים, חוץ מהשדות הבאים:

status_per_reporting_context
item_issues.

אפשר למיין את התשובות לפי כל השדות הזמינים, חוץ מהשדות הבאים:

gtin
status_per_reporting_context
item_issues

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

הנה דוגמה להחזרת המוצרים עם הסטטוס המצטבר ELIGIBLE_LIMITED, כלומר הם עומדים בדרישות להצגה לפחות בהקשר אחד של דיווח על טירגוט, אבל לא בכל ההקשרים. אתם יכולים לבקש את סטטוס המוצר המפורט לפי הקשר של הדיווח ובעיות במוצר כדי לבצע בדיקה נוספת. כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה של Merchant Center Query Language אל השיטה accounts.reports.search:

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  status_per_reporting_context,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'

זוהי דוגמה לתשובה מהשאילתה הקודמת:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
        "statusPerReportingContext": [
          {
            "reportingContext": "SHOPPING_ADS",
            "disapprovedCountries": [
              "US"
            ]
          },
          {
            "reportingContext": "FREE_LISTINGS",
            "approvedCountries": [
              "US"
            ]
          }
        ]
        "itemIssues": [
          {
            "type": {
              "code": "invalid_string_value",
              "canonicalAttribute": "n:product_code"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                },
                {
                  "reportingContext": "FREE_LISTINGS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DISAPPROVED"
            },
            "resolution": "MERCHANT_ACTION"
          },
          {
            "type": {
              "code": "apparel_missing_brand",
              "canonicalAttribute": "n:brand"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DEMOTED"
            },
            "resolution": "MERCHANT_ACTION"
          }
        ]
      }
    }
  ]
}

אתם יכולים להשתמש במסנן ב-reporting_context בסעיף WHERE כדי להציג פרטי מוצרים בהקשר דיווח ספציפי. כשמסננים לפי reporting_context, המערכת מחשבת את aggregated_reporting_context_status רק על סמך הקשר הנבחר של הדיווח, והערכים של status_per_reporting_context ושל item_issues הם רק הפרטים של אותו הקשר.

מידע נוסף על השדות שזמינים לשאילתה מופיע במאמר Fields in product_view table.

שיפור התמחור

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

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

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

הנה דוגמה שאפשר להשתמש בה כדי לראות את מחירי המבצע המוצעים למוצרים שלכם. כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה של Merchant Center Query Language אל השיטה accounts.reports.search:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_change_fraction
FROM price_insights_product_view