Search Ads 360 Reporting API החדש זמין עכשיו. כדי להתעדכן לגבי השיפורים והגרסאות שצפויים בקרוב, הצטרפו לקבוצת Google
searchads-api-announcements.
טווחי תאריכים
בשפת השאילתות של Search Ads 360 אפשר לציין את טווח התאריכים בשתי דרכים:
טווח תאריכים מותאם אישית
טווח תאריכים מוגדר מראש
טווח תאריכים מותאם אישית
אפשר לציין תאריכים בפורמט ISO 8601(YYYY-MM-DD):
segments.date BETWEEN '2019-01-01' AND '2019-01-31'
segments.date >= '2019-01-01' AND segments.date <= '2019-01-31'
תקופות זמן
חלק משדות התאריכים מתייחסים לתקופה מוגדרת מראש, במיוחד:
segments.weeksegments.monthsegments.quarter
כשמסננים לפי הפלחים האלה, אפשר להשתמש באופרטור = עם התאריך שהוא היום הראשון של תקופת הזמן. החל מגרסה 9, אם מציינים תאריך שהוא לא היום הראשון של תקופה, מוחזרת השגיאה MISALIGNED_DATE_FOR_FILTER.
לדוגמה, כדי לציין את החודש מאי בשנת 2021, צריך להשתמש בתנאים הבאים, תוך ציון היום הראשון של החודש:
segments.month = '2021-05-01'
טווח תאריכים מוגדר מראש
רשימת טווחי התאריכים המוגדרים מראש התקינים היא:
| טווח תאריכים |
המערכת יוצרת דוחות לגבי... |
TODAY |
רק היום. |
YESTERDAY |
רק אתמול. |
LAST_7_DAYS |
7 הימים האחרונים, לא כולל היום. |
LAST_BUSINESS_WEEK |
5 ימי העסקים, שני עד שישי, בשבוע העסקים הקודם. |
THIS_MONTH |
כל הימים בחודש הנוכחי. |
LAST_MONTH |
כל הימים בחודש הקודם. |
LAST_14_DAYS |
14 הימים האחרונים, לא כולל היום. |
LAST_30_DAYS |
30 הימים האחרונים, לא כולל היום. |
THIS_WEEK_SUN_TODAY |
התקופה שבין יום ראשון הקודם לבין היום הנוכחי. |
THIS_WEEK_MON_TODAY |
התקופה שבין יום שני הקודם לבין היום הנוכחי. |
LAST_WEEK_SUN_SAT |
התקופה של 7 הימים שמתחילה ביום ראשון הקודם. |
LAST_WEEK_MON_SUN |
התקופה של 7 הימים שמתחילה ביום שני הקודם. |
דוגמה:
segments.date DURING LAST_30_DAYS
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-03-03 (שעון UTC).
[null,null,["עדכון אחרון: 2025-03-03 (שעון UTC)."],[[["The Search Ads 360 Query Language allows specifying date ranges using either custom dates or predefined date ranges."],["Custom date ranges can be defined using ISO 8601 format and operators like `BETWEEN`, `\u003e=`, and `\u003c=`."],["Time period segments such as week, month, and quarter require filtering with the first day of the period using the `=` operator."],["Predefined date ranges offer shortcuts for common periods like `TODAY`, `LAST_7_DAYS`, `LAST_MONTH`, and others, simplifying query construction."],["Specifying a date that is not the first day of a period for segments like `segments.month` will result in a `MISALIGNED_DATE_FOR_FILTER` error."]]],["The Search Ads 360 Query Language uses custom or predefined date ranges. Custom ranges utilize ISO 8601 format (YYYY-MM-DD) for specific dates (e.g., `segments.date BETWEEN '2019-01-01' AND '2019-01-31'`). For segments like `week`, `month`, or `quarter`, filters must use the first day of the period. Predefined ranges, such as `TODAY`, `LAST_7_DAYS`, or `LAST_MONTH`, offer shortcuts (e.g., `segments.date DURING LAST_30_DAYS`).\n"]]
