rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
עדכונים אחרונים
לגבי תכונות חדשות, תיקוני באגים וגרסאות חדשות של Merchant API
add_alert
הערה: אנחנו נוציא משימוש את Content API for Shopping ב-18 באוגוסט 2026.
טווחי תאריכים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
שפת השאילתות של Merchant Center מאפשרת לכם לציין טווח תאריכים באמצעות טווח תאריכים מותאם אישית או יחסי. כל הבקשות למדדים חייבות לכלול תנאי עבור segments.dateבסעיף WHERE כדי לציין את פרק הזמן שממנו רוצים לאחזר את נתוני הביצועים.
טווח תאריכים מותאם אישית
אפשר לציין תאריכים בפורמט ISO 8601 (YYYY-MM-DD):
segments.date BETWEEN '2021-01-01' AND '2021-01-31'
או:
segments.date >= '2021-01-01' AND segments.date <= '2021-01-31'
אפשר להגדיר מחרוזות תאריכים עם גרש יחיד (') או עם מירכאות כפולות ("). עם זאת, צריך לשמור על עקביות. לדוגמה: "2021-01-01' היא לא מחרוזת תאריך תקינה.
טווח תאריכים יחסי
בנוסף לטווח תאריכים בהתאמה אישית, אפשר לציין טווח תאריכים יחסי כמו LAST_30_DAYS או THIS_MONTH באמצעות DURING במקום BETWEEN ו-AND:
WHERE segments.date DURING LAST_30_DAYS
במאמר בנושא הדקדוק של שפת השאילתות של Merchant Center מפורטת רשימה של טווחי תאריכים יחסיים זמינים.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-13 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-13 (שעון UTC)."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eAll Merchant Center Query Language requests for metrics require a \u003ccode\u003esegments.date\u003c/code\u003e condition in the \u003ccode\u003eWHERE\u003c/code\u003e clause to specify the desired time period for performance data retrieval.\u003c/p\u003e\n"],["\u003cp\u003eDate ranges can be specified using custom ISO 8601 formatted dates or relative date ranges like \u003ccode\u003eLAST_30_DAYS\u003c/code\u003e using \u003ccode\u003eDURING\u003c/code\u003e in the \u003ccode\u003eWHERE\u003c/code\u003e clause.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. All requests for performance metrics require a `segments.date` condition in the `WHERE` clause. Dates can be specified in ISO 8601 format within a custom range using `BETWEEN` or `\u003e=` and `\u003c=`. Alternatively, relative date ranges like `LAST_30_DAYS` can be specified with `DURING`. For a list of available date ranges, the grammar documentation should be consulted.\n"],null,["# Date ranges\n\nThe Merchant Center Query Language lets you specify a date range using a custom\nor relative date range. **All requests for metrics must include a condition for\n`segments.date` in the`WHERE` clause** to indicate the time period from which\nyou want to retrieve your performance data.\n\nCustom date range\n-----------------\n\nYou can specify dates in ISO 8601(YYYY-MM-DD) format: \n\n segments.date BETWEEN '2021-01-01' AND '2021-01-31'\n\nOR: \n\n segments.date \u003e= '2021-01-01' AND segments.date \u003c= '2021-01-31'\n\nYou can define date strings with either single quotes (`'`) or double quotes\n(`\"`). However, you must be consistent; for example: `\"2021-01-01'` is not a\nvalid date string.\n\nRelative date range\n-------------------\n\nIn addition to custom date ranges, you can specify a relative date range such\nas `LAST_30_DAYS` or `THIS_MONTH` by using `DURING` instead of `BETWEEN` and\n`AND`: \n\n WHERE segments.date DURING LAST_30_DAYS\n\nCheck out the\n[Merchant Center Query Language grammar](/shopping-content/guides/reports/query-language/grammar)\nfor the list of available relative date ranges."]]
