บันทึกประจำรุ่น

หน้านี้มีบันทึกประจำรุ่นสำหรับ AdSense Management API

เวอร์ชัน 2

เวอร์ชันนี้มีการเปลี่ยนแปลงต่อไปนี้เพื่อนำฟังก์ชันที่เลิกใช้งานแล้วออกและเพื่อให้ AdSense Management API สอดคล้องกับมาตรฐาน Google API ปัจจุบัน ตามรูปแบบการกำหนดเวอร์ชันของ Google API เราจะอัปเดตเวอร์ชันนี้เมื่อเวลาผ่านไปเพื่อรวมฟังก์ชันการทำงานเพิ่มเติม (เข้ากันได้แบบย้อนหลัง) แทนที่จะเปิดตัวฟังก์ชันการทำงานใหม่ ในเวอร์ชันย่อยแยกต่างหาก

2025-10-02

รายงาน

• เพิ่มมิติข้อมูล TRAFFIC_SOURCE ซึ่งช่วยให้สามารถแบ่งเมตริกตาม แหล่งที่มาของการเข้าชม (เช่น "Google", "Bing", "Facebook", "อื่นๆ") ดูข้อมูลเพิ่มเติมได้ที่รายละเอียดแหล่งที่มาของการเข้าชม

2025-05-06

PolicyIssues

• ตอนนี้ระบบจะตั้งค่าฟิลด์ policyTopics[].must_fix ที่เลิกใช้งานแล้ว (ดูการอัปเดตก่อนหน้า) เป็น false เสมอ

2025-02-24

PolicyIssues

• เพิ่มpolicyTopics[].typeฟิลด์เพื่อระบุว่าหัวข้อนโยบายแสดงถึงปัญหาเกี่ยวกับนโยบาย ปัญหาเกี่ยวกับกฎระเบียบ หรือค่ากำหนดของผู้ลงโฆษณา ซึ่งจะแทนที่ policyTopics[].must_fix ซึ่งตอนนี้มีเครื่องหมายระบุว่าเป็นฟิลด์ที่เลิกใช้งานแล้ว

2024-04-03

PolicyIssues

• เพิ่มคอลเล็กชันใหม่เพื่อรายงานการละเมิดนโยบายและคำเตือนปัจจุบันที่บัญชีได้รับ

2023-06-19

การชำระเงิน

• ตอนนี้ payments.list จะแสดงรายละเอียดเกี่ยวกับการชำระเงินสำหรับผู้เผยแพร่โฆษณาพรีเมียม

2023-06-13

รายงาน

• เพิ่มเมตริก FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS และ FUNNEL_RPM ซึ่งให้ข้อมูลเกี่ยวกับประสิทธิภาพของหน่วยที่ไม่ใช่โฆษณา (เช่น หน่วยการค้นหาที่เกี่ยวข้อง)

2023-03-30

รายงาน

• เพิ่มPAGE_URLมิติข้อมูล ซึ่งช่วยให้สามารถแบ่งเมตริกตาม URL ของหน้าเว็บ (มีข้อควรระวังบางประการ โปรดดูการแบ่ง URL ของหน้าเว็บ)

2022-09-21

AdUnits

• เพิ่มเมธอด create และ patch โปรดทราบว่าวิธีเหล่านี้ใช้ได้เฉพาะกับโปรเจ็กต์ที่เปิดใช้ผลิตภัณฑ์ AdSense for Platforms เท่านั้น

CustomChannels

• เพิ่มเมธอด create, patch และ update โปรดทราบว่าวิธีเหล่านี้ใช้ได้เฉพาะกับโปรเจ็กต์ที่เปิดใช้ผลิตภัณฑ์ AdSense for Platforms เท่านั้น
• เพิ่มฟิลด์ active ลงในทรัพยากร

บัญชี

• เพิ่มเมธอด getAdBlockingRecoveryTag

2022-08-25

รายงาน

• เพิ่มมิติข้อมูล HOSTED_AD_CLIENT_ID ซึ่งช่วยให้ผู้เผยแพร่โฆษณาที่เป็นโฮสต์และแพลตฟอร์มสามารถแบ่งเมตริกตามบัญชีของผู้เผยแพร่โฆษณา (ผู้เผยแพร่โฆษณาที่เป็นโฮสต์) และตามบัญชีย่อย (ผู้เผยแพร่โฆษณาที่เป็นแพลตฟอร์ม)

2022-05-03

AdClient

• เพิ่มเมธอด get

รายงาน

• เพิ่มเมธอด getSaved

UrlChannels

• เพิ่มเมธอด get

2022-03-31

บัญชี

• ตอนนี้ API จะแสดงบัญชีที่ไม่ได้ใช้งานพร้อมฟิลด์ state ซึ่งระบุ สถานะของบัญชี

AdClient

• เช่นเดียวกับการเปลี่ยนแปลงบัญชี ตอนนี้ API จะแสดงไคลเอ็นต์โฆษณาที่ไม่มีการใช้งาน โดยมีฟิลด์ state ซึ่งระบุ สถานะของไคลเอ็นต์โฆษณา

2022-02-24

การชำระเงิน

• เราได้ขยายรูปแบบชื่อทรัพยากรเพื่อรองรับทรัพยากรแยกต่างหาก สำหรับรายได้จาก YouTube การเปลี่ยนแปลงนี้เกิดขึ้นก่อนการเปิดตัวแบบเป็นระยะของ ประสบการณ์การใช้งาน AdSense ที่ปรับปรุงแล้ว สำหรับครีเอเตอร์ YouTube ซึ่งจะแยกรายได้จาก YouTube ไปยังบัญชีการชำระเงินของ YouTube เอง นอกจากนี้ ระบบจะแสดงข้อมูลการชำระเงินของ YouTube จากวิธีการแสดงรายการการชำระเงินเมื่อคุณมีบัญชีการชำระเงินเฉพาะสำหรับรายได้จาก YouTube รายได้จาก YouTube จะมีรูปแบบชื่อทรัพยากรดังนี้
  • accounts/{account}/payments/youtube-unpaid สำหรับรายได้จาก YouTube ที่ยังไม่ได้ชำระ (ปัจจุบัน)
  • accounts/{account}/payments/youtube-yyyy-MM-dd สำหรับรายได้จาก YouTube แบบชำระเงิน
  
  หมายเหตุ: ชื่อทรัพยากรสำหรับรายได้จาก AdSense จะยังคงเหมือนเดิม
  • accounts/{account}/payments/unpaid สำหรับรายได้ AdSense ที่ยังไม่ได้ชำระ (ปัจจุบัน)
  • accounts/{account}/payments/yyyy-MM-dd สำหรับรายได้จาก AdSense ที่ชำระแล้ว

2021-06-30

โปรดรายงาน

• เพิ่มมิติข้อมูล AD_FORMAT_NAME และ AD_FORMAT_CODE ซึ่งระบุวิธีที่โฆษณาแสดงต่อผู้ใช้ ในเว็บไซต์ (ในหน้า วิกเน็ตต์ ฯลฯ) โปรดทราบว่า v1.4 มีมิติข้อมูล (เลิกใช้งานแล้ว) ที่มีชื่อเดียวกันแต่มีสมาชิกต่างกัน มิติข้อมูล 2 รายการ ที่เพิ่มใน v2 นั้นแตกต่างจากมิติข้อมูลที่มีอยู่ใน v1.4

2021-04-19 (รุ่นแรก)

ทั่วไป

• เราได้นำเมธอดที่เลิกใช้งานแล้วทั้งหมดใน v1.4 ออกแล้ว ซึ่งรวมถึงวิธีการของทรัพยากร ที่ไม่ต้องใช้ accountId ใน v2 จะมีการระบุ accountId ในช่อง parent
• ตามมาตรฐาน Google API ตอนนี้ระบบจะระบุทรัพยากรด้วยฟิลด์ name เช่น ชื่อของ AdClient จะมีลักษณะดังนี้ accounts/{accountId}/adclients/{adClientId} นอกจากนี้ ใน v1.4 มีการใช้รหัสทรัพยากรเป็นมิติข้อมูลการรายงาน แต่ใน v2 ค่าดังกล่าว จะพร้อมใช้งานผ่านreporting_dimension_idฟิลด์ ในทรัพยากรหลายรายการ
• ระบบได้นำฟิลด์ kind ออกจากทรัพยากรทั้งหมดแล้ว

บัญชี

• ฟิลด์ name เปลี่ยนเป็น display_name แล้ว
• ฟิลด์ timezone เปลี่ยนจากสตริงเป็น google.type.TimeZone
• ฟิลด์ creation_time (ประเภท int64) เปลี่ยนเป็น create_time (ประเภท google.protobuf.Timestamp) แล้ว
• เพิ่มฟิลด์ pending_tasks ซึ่งเป็นรายการงานที่ค้างอยู่ ซึ่งต้องดำเนินการให้เสร็จสมบูรณ์ในกระบวนการลงชื่อสมัครใช้สำหรับบัญชีใหม่ เช่น งานอาจเกี่ยวข้องกับโปรไฟล์การเรียกเก็บเงินหรือ การยืนยันทางโทรศัพท์
• ระบบได้นำช่อง sub_accounts ออกแล้ว ฟังก์ชันการทำงานที่คล้ายกัน สามารถทำได้ใน v2 ด้วยlistChildAccounts วิธีการที่กำหนดเอง คุณสร้างแผนผังบัญชีย่อยทั้งหมดใน v2 ได้โดยเรียกใช้ listChildAccounts แบบเรียกซ้ำ

AdClient

• นำฟิลด์ arc_opt_in ออกเนื่องจากได้นำออกจาก UI ของ AdSense แล้ว
• ฟิลด์ supports_reporting จะแทนที่ด้วยฟิลด์ reporting_dimension_id ซึ่งแสดงถึงรหัสที่ไม่ซ้ำ ของไคลเอ็นต์โฆษณาตามที่ใช้ในมิติข้อมูลการรายงาน AD_CLIENT_ID หาก reporting_dimension_id ว่างเปล่า แสดงว่า AdClient ไม่รองรับการรายงาน

AdUnit

• เปลี่ยนชื่อฟิลด์ status เป็น state แล้ว นอกจากนี้ สถานะ ACTIVE จะไม่ระบุอีกต่อไปว่ามี กิจกรรมในหน่วยโฆษณานี้ในช่วง 7 วันที่ผ่านมาหรือไม่ ใน v2 หมายความว่าผู้ใช้ได้เปิดใช้งานหน่วยโฆษณาแล้วและสามารถแสดงโฆษณาได้
• ระบบได้นำช่อง code ออกแล้ว ค่านี้ยังคงดูได้ที่ส่วนท้ายของฟิลด์ name (หลังจากเครื่องหมายทับสุดท้าย)
• ระบบได้นำช่อง contentAdsSettings.backupOption ออกแล้ว
• ฟิลด์ type ถูกจำกัดให้ใช้ค่า TYPE_UNSPECIFIED, DISPLAY, FEED ARTICLE, MATCHED_CONTENT และ LINK
• นอกจากนี้ เรายังนำช่องอื่นๆ ที่นำออกไปแล้วใน UI ของ AdSense ออกด้วย ได้แก่ custom_style, saved_style_id, mobile_content_ads_settings, feed_ads_settings

การแจ้งเตือน

• ระบบได้นำวิธีการ delete ออกแล้ว
• ระบบได้นำช่อง is_dismissible ออกแล้ว
• เปลี่ยนชื่อฟิลด์ locale เป็น language_code แล้ว

CustomChannel

• ระบบได้นำช่อง code ออกแล้ว ค่านี้ยังคงดูได้ที่ส่วนท้ายของฟิลด์ name (หลังจากเครื่องหมายทับสุดท้าย)
• เราได้นำฟิลด์ targeting_info ออกแล้วเนื่องจากได้นำออกจาก UI ของ AdSense แล้ว

การชำระเงิน

• เราได้เปลี่ยนชื่อฟิลด์ payment_date เป็น date และเปลี่ยนจากประเภทสตริงเป็นประเภท google.type.Date
• ระบบได้รวมฟิลด์ payment_amount และ ฟิลด์ payment_amount_currency_code ไว้ใน ฟิลด์ payment เดียว (เช่น "¥1,235 JPY", "$1,234.57", "£87.65")

โปรดรายงาน

• ในเวอร์ชัน 2 ข้อมูลการรายงาน AdSense Management API จะสอดคล้องกับ UI ของ AdSense แล้ว ซึ่งหมายความว่าระบบจะไม่รองรับพร็อพเพอร์ตี้ AdMob และ YouTube อีกต่อไป นอกจากนี้ API จะรองรับเฉพาะข้อมูลรายงานย้อนหลัง 3 ปี เท่านั้น
• ระบบได้นำMetadata.dimensionsและ Metadata.metricsออกแล้ว
• เราได้เพิ่มวิธีการใหม่ในการสร้างรายงานเวอร์ชัน CSV ซึ่งจะแทนที่พารามิเตอร์การค้นหาใน v1.4 หมายเหตุ: คุณยังคงใช้ส่วนหัว HTTP "Accept-Encoding: gzip" สำหรับการบีบอัดได้
• เราได้เปลี่ยนฟิลด์บางรายการในการสร้างรายงานเฉพาะกิจ
  • เปลี่ยนชื่อฟิลด์ account_id เป็น account แล้ว
  • เปลี่ยนชื่อฟิลด์ dimension เป็น dimensions แล้ว
  • เปลี่ยนชื่อฟิลด์ metric เป็น metrics แล้ว
  • เปลี่ยนชื่อฟิลด์ filter เป็น filters แล้ว
  • เปลี่ยนชื่อฟิลด์ sort เป็น order_by แล้ว
  • เปลี่ยนชื่อฟิลด์ locale เป็น language_code แล้ว
  • เปลี่ยนชื่อฟิลด์ currency เป็น currency_code แล้ว
  • ตอนนี้คุณระบุช่วงที่ใช้กันทั่วไปได้หลายช่วงด้วย date_range (เช่น TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS และ LAST_30_DAYS) หรือคุณจะ ระบุ start_date และ end_date โดยตั้งค่า date_range เป็น CUSTOM ก็ได้
  • ฟิลด์ start_date และ end_date เปลี่ยนจากประเภทสตริงเป็นประเภท google.type.Date หมายเหตุ: เป็นผลให้ คีย์เวิร์ดวันที่สัมพัทธ์ (เช่น "today-6d") อีกต่อไป
  • ฟิลด์บูลีน use_timezone_reporting ถูกแทนที่ด้วย reporting_time_zone ซึ่งอาจมีค่าใดค่าหนึ่งใน 2 ค่า ได้แก่ ACCOUNT_TIME_ZONE หรือ GOOGLE_TIME_ZONE (ซึ่งหมายถึง PST/PDT) ค่าเริ่มต้นใน v2 คือ ACCOUNT_TIME_ZONE ซึ่งแตกต่างจากค่าเริ่มต้นใน v1.4
  • ระบบได้นำช่อง start_index ออกแล้ว
  • เปลี่ยนชื่อฟิลด์ max_results เป็น limit แล้ว
• มีการเปลี่ยนแปลงฟิลด์บางรายการในการสร้างรายงานที่บันทึกไว้
  • ฟิลด์วันที่ที่เพิ่ม (date_range, start_date, end_date, reporting_time_zone)
  • เพิ่มฟิลด์ currency_code แล้ว
  • เปลี่ยนชื่อฟิลด์ locale เป็น language_code แล้ว
  • ระบบได้นำช่อง start_index ออกแล้ว
  • ระบบได้นำช่อง max_results ออกแล้ว

SavedAdStyle

• SavedAdStyle ถูกนำออกเนื่องจากถูกนำออกจาก UI ของ AdSense แล้ว

เว็บไซต์

• Sites ได้รับการเพิ่มเพื่อดึงข้อมูลเกี่ยวกับเว็บไซต์ที่คุณเพิ่ม ลงในบัญชี AdSense
• ฟิลด์ state แสดงว่าเว็บไซต์อยู่ในสถานะต่อไปนี้หรือไม่ REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION
• ฟิลด์ auto_ads_enabled เป็นบูลีนที่แสดงว่า มีการเปิดใช้โฆษณาอัตโนมัติในเว็บไซต์หนึ่งๆ หรือไม่

เวอร์ชัน 1.4

เวอร์ชันนี้มีฟังก์ชันการทำงานต่อไปนี้

• ตอนนี้คุณสามารถแสดงการชำระเงินของบัญชี AdSense ในสกุลเงินที่เกี่ยวข้องได้แล้ว
• ตอนนี้คุณสามารถปิดการแจ้งเตือนได้โดยเรียกใช้เมธอด delete ซึ่งจะซ่อนการแจ้งเตือนใน API และอินเทอร์เฟซเว็บของ AdSense
• ตอนนี้การตอบกลับรายงานมีวันที่เริ่มต้นและวันที่สิ้นสุดแล้ว ซึ่งเป็นสิ่งสำคัญ หากคุณใช้วันที่แบบสัมพัทธ์เมื่อสร้างรายงาน (เช่น today, yesterday, firstDayOfMonth-1m) ตอนนี้การตอบกลับจะมีช่วงวันที่ที่คุณขอ

ปัญหาที่ทราบ

เวอร์ชันนี้ไม่รองรับฟิลด์ currency ในรายงาน

เวอร์ชัน 1.3

เวอร์ชันนี้มีฟังก์ชันการทำงานต่อไปนี้

• ความสามารถในการดึงข้อมูลการแจ้งเตือน
• ความสามารถในการดึงข้อมูลเมตาของเมตริกและมิติข้อมูล
• ความสามารถในการเรียกใช้รายงานในเขตเวลาท้องถิ่นของบัญชี

ปัญหาที่ทราบ

เวอร์ชันนี้ไม่รองรับฟิลด์ currency ในรายงาน

เวอร์ชัน 1.2

เวอร์ชันนี้มีฟังก์ชันการทำงานต่อไปนี้

• ความสามารถในการดึงข้อมูลรูปแบบโฆษณา
• ความสามารถในการดึงและเรียกใช้รายงานที่บันทึกไว้ซึ่งกำหนดไว้ในส่วนหน้า

ปัญหาที่ทราบ

เวอร์ชันนี้ไม่รองรับฟิลด์ currency ในรายงาน

เวอร์ชัน 1.1

เวอร์ชันนี้มีฟังก์ชันการทำงานต่อไปนี้

• ความสามารถในการแสดงรายการบัญชีที่ผู้ใช้มีสิทธิ์เข้าถึง
• ความสามารถในการเรียกใช้ GET ในบัญชีที่เฉพาะเจาะจง
• ความสามารถในการเรียก GET ในหน่วยโฆษณาและแชแนลที่กำหนดเอง
• ความสามารถในการระบุการเชื่อมต่อระหว่างหน่วยโฆษณากับแชแนลที่กำหนดเอง
• แชแนลที่กำหนดเองมีข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลการกำหนดเป้าหมาย

นอกจากนี้ ตอนนี้คุณยังเข้าถึงข้อมูลได้ทั้งในบัญชีเริ่มต้นหรือในบัญชีที่เฉพาะเจาะจง

ปัญหาที่ทราบ

เวอร์ชันนี้ไม่รองรับฟิลด์ currency ในรายงาน

เวอร์ชัน 1

นี่คือรุ่นแรกของ API ซึ่งรวมถึงการรองรับการดึงข้อมูลไคลเอ็นต์โฆษณา หน่วยโฆษณา แชแนลที่กำหนดเอง แชแนล URL รวมถึงการเรียกใช้รายงาน

ปัญหาที่ทราบ

เวอร์ชันนี้ไม่รองรับฟิลด์ currency ในรายงาน