การรายงานเขตเวลาท้องถิ่น
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
การรายงานเขตเวลาท้องถิ่นช่วยให้คุณสามารถเรียกใช้รายงานในเขตเวลาท้องถิ่นของบัญชี AdSense ได้ ใน AdSense Management API เวอร์ชัน 2 ฟังก์ชันนี้จะเปิดใช้โดยค่าเริ่มต้น
การตั้งค่าสิ่งต่างๆ
ในกรณีส่วนใหญ่ สิ่งที่ต้องใช้ในการรายงานเขตเวลาท้องถิ่นคือผู้ใช้ AdSense ในการกำหนดค่าเขตเวลาท้องถิ่นของบัญชี ซึ่งจะช่วยให้เลือกเขตเวลาที่มีความเกี่ยวข้องกับผู้ใช้มากขึ้น และใช้เขตเวลานั้นในเว็บไซต์ AdSense และรายงาน AdSense Management API ได้
การขอรายงาน
เว็บไซต์ AdSense และ AdSense Management API จะใช้เขตเวลาท้องถิ่นของบัญชีโดยค่าเริ่มต้นเพื่อสร้างรายงาน สำหรับ AdSense Management API ตัวเลือกนี้ควบคุมผ่านพารามิเตอร์ reportingTimeZone
(ดู ReportingTimeZone
) สำหรับคำขอการสร้างทั้งเฉพาะกิจและรายงานที่บันทึกไว้
หากต้องการปิดใช้การรายงานเขตเวลาท้องถิ่น ควรตั้งค่าพารามิเตอร์ reportingTimeZone
เป็น GOOGLE_TIME_ZONE
วิธีนี้จะสร้างรายงานโดยใช้เขตเวลาสำหรับการเรียกเก็บเงิน (คือ America/Los_Angeles เสมอ)
โปรดทราบว่าหากผู้ใช้ไม่เคยตั้งค่าเขตเวลาท้องถิ่นสำหรับบัญชี ระบบจะถือว่าเขตเวลาของบัญชีเป็น America/Los_Angeles เหมือนกับเขตเวลาสำหรับการเรียกเก็บเงิน
สิ่งที่ต้องระวัง
การเปลี่ยนแปลงเขตเวลา
เมื่อใดก็ตามที่เขตเวลาของบัญชีมีการเปลี่ยนแปลง จะมีช่วงเวลาเปลี่ยนผ่านสั้นๆ ไม่เกิน 2 วันซึ่งข้อมูลการรายงานอาจไม่สอดคล้องกัน ข้อมูลนี้จะยังคงไม่สอดคล้องกัน ดังนั้น โปรดระมัดระวังเรื่องจุดเปลี่ยนเหล่านี้ในแอปพลิเคชันของคุณ หากเป็นไปได้
ตัวอย่างหนึ่งของการเปลี่ยนเหล่านี้โดยเฉพาะคือเมื่อมีการตั้งค่าเขตเวลาท้องถิ่นของบัญชีเป็นครั้งแรก ซึ่งจะเป็นการเปลี่ยนจากเขตเวลาเริ่มต้นของบัญชีเป็นเขตเวลาที่เลือก
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-26 UTC
[null,null,["อัปเดตล่าสุด 2025-07-26 UTC"],[[["\u003cp\u003eAdSense reports are now generated in the user's local time zone by default, offering a more relevant view of data.\u003c/p\u003e\n"],["\u003cp\u003eUsers can configure their preferred time zone within their AdSense account settings for use across the website and API.\u003c/p\u003e\n"],["\u003cp\u003eReports can be generated using the billing time zone (America/Los_Angeles) by explicitly setting the \u003ccode\u003ereportingTimeZone\u003c/code\u003e parameter to \u003ccode\u003eGOOGLE_TIME_ZONE\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eChanging the account's time zone may result in inconsistent reporting data for a brief period, which should be taken into consideration.\u003c/p\u003e\n"]]],["AdSense's local time zone reporting, enabled by default in API v2, allows reports to use the user's chosen time zone. Users must configure their account's local time zone. The `reportingTimeZone` parameter manages this in the API; setting it to `GOOGLE_TIME_ZONE` uses the billing time zone (America/Los_Angeles). If no user timezone is set the billing time zone is used. Time zone changes may cause up to two days of inconsistent reporting data.\n"],null,["# Local Time Zone Reporting\n\nLocal time zone reporting allows you to run reports in the AdSense account's local time zone. As of v2 of the AdSense Management API, this functionality is enabled by default.\n\nSetting things up\n-----------------\n\nIn most cases, all that is required to use local time zone reporting is for the AdSense user to [configure their account's local time zone](https://support.google.com/adsense/answer/9830725). This allows them to choose a time zone that is more relevant to them, and use it across the AdSense website and AdSense Management API reports.\n\nRequesting a report\n-------------------\n\nThe AdSense website and AdSense Management API will use the account's local time zone by default to generate reports. For the AdSense Management API, this choice is controlled via a `reportingTimeZone` parameter (see [`ReportingTimeZone`](/adsense/management/reference/rest/v2/ReportingTimeZone)) for both [ad hoc](/adsense/management/reference/rest/v2/accounts.reports) and [saved report](/adsense/management/reference/rest/v2/accounts.reports.saved) generation requests.\n\nTo disable local time zone reporting, the `reportingTimeZone` parameter should be set to `GOOGLE_TIME_ZONE`; this generates reports using the billing time zone (always America/Los_Angeles).\n\nNote that if the user has never [set the local time zone for the account](https://support.google.com/adsense/answer/9830725), their account time zone will be considered to be America/Los_Angeles, the same as the billing time zone.\n\nThings to watch out for\n-----------------------\n\n### Changing time zones\n\nWhenever the time zone for an account is changed, there will be a short transition period of up to two days where the reporting data will potentially be inconsistent. This data will always remain inconsistent, so be careful to note these transition points in your application, if possible.\n\nOne particularly relevant example of these transitions is when the local time zone for an account is first set: this will essentially be a switch from the default account time zone to the chosen time zone."]]