Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว เข้าร่วมกลุ่ม Google
searchads-api-announcements เพื่อติดตามการปรับปรุงและรุ่นที่กำลังจะเปิดตัว
ช่วงวันที่
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ภาษาการค้นหาของ Search Ads 360 ช่วยให้คุณระบุช่วงวันที่ได้ 2 วิธี ดังนี้
กำหนดช่วงวันที่เอง
คุณระบุวันที่ในรูปแบบ 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
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
[null,null,["อัปเดตล่าสุด 2025-08-29 UTC"],[[["\u003cp\u003eThe Search Ads 360 Query Language allows specifying date ranges using either custom dates or predefined date ranges.\u003c/p\u003e\n"],["\u003cp\u003eCustom date ranges can be defined using ISO 8601 format and operators like \u003ccode\u003eBETWEEN\u003c/code\u003e, \u003ccode\u003e>=\u003c/code\u003e, and \u003ccode\u003e<=\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTime period segments such as week, month, and quarter require filtering with the first day of the period using the \u003ccode\u003e=\u003c/code\u003e operator.\u003c/p\u003e\n"],["\u003cp\u003ePredefined date ranges offer shortcuts for common periods like \u003ccode\u003eTODAY\u003c/code\u003e, \u003ccode\u003eLAST_7_DAYS\u003c/code\u003e, \u003ccode\u003eLAST_MONTH\u003c/code\u003e, and others, simplifying query construction.\u003c/p\u003e\n"],["\u003cp\u003eSpecifying a date that is not the first day of a period for segments like \u003ccode\u003esegments.month\u003c/code\u003e will result in a \u003ccode\u003eMISALIGNED_DATE_FOR_FILTER\u003c/code\u003e error.\u003c/p\u003e\n"]]],["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"],null,["# Date Ranges\n\nThe Search Ads 360 Query Language lets you specify the date range in two ways:\n\n- custom date range\n\n- predefined date range\n\nCustom date range\n-----------------\n\nYou can specify dates in ISO 8601(`YYYY-MM-DD`) format: \n\n segments.date BETWEEN '2019-01-01' AND '2019-01-31'\n\n segments.date \u003e= '2019-01-01' AND segments.date \u003c= '2019-01-31'\n\n### Time periods\n\nSome date fields refer to a predefined period of time, specifically:\n\n- `segments.week`\n- `segments.month`\n- `segments.quarter`\n\nWhen filtering on these segments, you can use the `=` operator with the date\nthat is the first day of the time period. Starting in v9, if you specify a date\nthat is not the first day of a period, a `MISALIGNED_DATE_FOR_FILTER` error is\nreturned.\n\nFor example, to specify the month of May in the year 2021, you would use the\nfollowing condition, specifying the first day of that month: \n\n segments.month = '2021-05-01'\n\nPredefined date range\n---------------------\n\nThe list of valid predefined date ranges is as follows:\n\n| Date range | Reports are generated for... |\n|-----------------------|--------------------------------------------------------------------------------|\n| `TODAY` | Today only. |\n| `YESTERDAY` | Yesterday only. |\n| `LAST_7_DAYS` | The last 7 days not including today. |\n| `LAST_BUSINESS_WEEK` | The 5 day business week, Monday through Friday, of the previous business week. |\n| `THIS_MONTH` | All days in the current month. |\n| `LAST_MONTH` | All days in the previous month. |\n| `LAST_14_DAYS` | The last 14 days not including today. |\n| `LAST_30_DAYS` | The last 30 days not including today. |\n| `THIS_WEEK_SUN_TODAY` | The period between the previous Sunday and the current day. |\n| `THIS_WEEK_MON_TODAY` | The period between the previous Monday and the current day. |\n| `LAST_WEEK_SUN_SAT` | The 7-day period starting with the previous Sunday. |\n| `LAST_WEEK_MON_SUN` | The 7-day period starting with the previous Monday. |\n\nExample: \n\n segments.date DURING LAST_30_DAYS"]]
