การเปลี่ยนแปลงเพื่อรองรับกฎระเบียบเกี่ยวกับโฆษณาทางการเมืองของสหภาพยุโรปใน Google Ads API และสคริปต์ Google Ads

วันพฤหัสบดีที่ 7 สิงหาคม 2025

สิ่งที่เปลี่ยนแปลงไป

ตามที่ได้ประกาศไปเมื่อปีที่แล้ว Google จะหยุดแสดงการโฆษณาด้านการเมืองในสหภาพยุโรปก่อนที่กฎระเบียบใหม่จะมีผลบังคับใช้ในเดือนตุลาคม 2025 ในวันที่ 3 กันยายน 2025 Google Ads API และสคริปต์ Google Ads จะเปิดตัวการบังคับใช้ที่เกี่ยวข้องกับการเปลี่ยนแปลงนี้ หากคุณใช้ผลิตภัณฑ์ใดผลิตภัณฑ์หนึ่งเหล่านี้เพื่อสร้างหรือจัดการแคมเปญ คุณอาจต้องอัปเดตแอปพลิเคชันเพื่อจัดการการบังคับใช้เหล่านี้ก่อนวันที่ 3 กันยายน 2025

การรองรับ API สำหรับการประกาศตนเองเกี่ยวกับโฆษณาทางการเมืองในสหภาพยุโรป

Google Ads API และสคริปต์ Google Ads ได้เพิ่มการรองรับการประกาศด้วยตนเองว่าแคมเปญมีโฆษณาทางการเมืองในสหภาพยุโรปหรือไม่ ดูวิธีกําหนดโฆษณาทางการเมืองในสหภาพยุโรปที่นี่ API เวอร์ชัน v19.2, v20.1 และ v21 มีช่องใหม่ชื่อ contains_eu_political_advertising ในออบเจ็กต์ Campaign. ค่าที่เป็นไปได้และความหมายแสดงอยู่ในตารางด้านล่าง

ค่า ความหมาย
CONTAINS_EU_POLITICAL_ADVERTISING แคมเปญมีโฆษณาทางการเมืองในสหภาพยุโรป
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING แคมเปญไม่มีโฆษณาทางการเมืองในสหภาพยุโรป
UNSPECIFIED แคมเปญไม่มีการประกาศตนเองเกี่ยวกับโฆษณาทางการเมืองในสหภาพยุโรป

คุณสามารถดึงข้อมูลสถานะการประกาศด้วยตนเองของแคมเปญใน Google Ads API ได้โดยเรียกใช้การค้นหาต่อไปนี้โดยใช้เมธอด Search หรือ SearchStream ของ GoogleAdsService สำหรับสคริปต์ Google Ads ให้ใช้เมธอด AdsApp.search หรือ AdsApp.report 

select campaign.id, campaign.contains_eu_political_advertising from campaign

หากใช้ไลบรารีของไคลเอ็นต์ Google Ads API คุณอาจต้องดาวน์โหลดไลบรารีเวอร์ชันล่าสุดเพื่อใช้ฟังก์ชันนี้ใน API เวอร์ชัน v19 และ v20

การเปลี่ยนแปลงการตรวจสอบและการบังคับใช้ API

ในวันที่ 3 กันยายน 2025 Google Ads API และสคริปต์ Google Ads จะเริ่มบังคับใช้การตรวจสอบต่อไปนี้ใน API เวอร์ชัน v19 และ v20

  • แคมเปญใหม่ทั้งหมดที่สร้างผ่าน Google Ads API หรือสคริปต์ Google Ads ควรตั้งค่าช่อง contains_eu_political_advertising การเรียก API เพื่อสร้างแคมเปญใหม่โดยใช้ CampaignService.MutateCampaigns จะไม่สำเร็จและแสดงข้อผิดพลาด FieldError.REQUIRED หากไม่ได้ตั้งค่าช่องนี้ สคริปต์ Google Ads จะบังคับใช้การตรวจสอบเหล่านี้เมื่อสร้างแคมเปญโดยใช้เมธอด AdsApp.mutate หรือ AdsApp.mutateAll
  • แคมเปญที่มีอยู่ทั้งหมดควรตั้งค่าช่อง contains_eu_political_advertising ก่อนที่จะพยายามเปลี่ยนproximity, location,หรือ location_group การกำหนดเป้าหมายที่ระดับแคมเปญหรือกลุ่มโฆษณา การเรียก API เพื่อสร้างหรืออัปเดตเกณฑ์แคมเปญเหล่านี้โดยใช้เมธอด CampaignCriterionService.MutateCampaignCriteria สำหรับแคมเปญที่มีอยู่จะไม่สำเร็จและแสดงข้อผิดพลาด CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION หากแคมเปญยังไม่ได้ทำการประกาศด้วยตนเองให้เสร็จสมบูรณ์ การเรียก API เพื่อสร้างหรืออัปเดตเกณฑ์กลุ่มโฆษณาเหล่านี้โดยใช้ AdGroupCriterionService.MutateAdGroupCriteria จะไม่สําเร็จในลักษณะเดียวกันหากแคมเปญยังไม่ได้ประกาศด้วยตนเองจนเสร็จสมบูรณ์ สคริปต์ Google Ads จะบังคับใช้การตรวจสอบเหล่านี้เมื่อพยายามเปลี่ยนการกำหนดเป้าหมายโดยใช้เมธอด AdsApp.mutate, AdsApp.mutateAll, AdsApp.Campaign.addProximity และ AdsApp.Campaign.addLocation
  • การบังคับใช้นี้ยังมีผลกับกลไกอื่นๆ ที่คุณใช้สร้างแคมเปญได้ด้วย เช่น การเรียกใช้งานแบบกลุ่มและการใช้เมธอด GoogleAdsService.Mutate เพื่อสร้างและอัปเดตเอนทิตี
  • การพยายามกำหนดเวลาการทดสอบใหม่โดยใช้เมธอด ExperimentService.ScheduleExperiment จะทำให้เกิดข้อผิดพลาด ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION หากไม่มี contains_eu_political_advertising declaration ในแคมเปญร่างกลุ่มทดสอบ
  • หากคุณใช้ฟีเจอร์อัปโหลดหลายรายการพร้อมกันในสคริปต์ Google Ads โปรดดูเอกสารประกอบของผลิตภัณฑ์เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงเทมเพลตสเปรดชีตที่จำเป็นซึ่งเป็นส่วนหนึ่งของการเปลี่ยนแปลงนี้

การตรวจสอบเหล่านี้มีการบังคับใช้อยู่แล้วใน Google Ads API เวอร์ชัน v21

การเปลี่ยนแปลงนี้จะส่งผลต่อการแสดงแคมเปญอย่างไร

แคมเปญที่ประกาศโฆษณาทางการเมืองในสหภาพยุโรปโดยตั้งค่า contains_eu_political_advertising เป็น true จะหยุดแสดงโฆษณาในสหภาพยุโรปในวันที่ 22 กันยายน 2025. ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือ

แคมเปญที่มีอยู่ซึ่งไม่มีการประกาศจะไม่ได้รับผลกระทบในขณะนี้ เราขอแนะนำให้อัปเดตแคมเปญที่มีอยู่ในบัญชีด้วยการประกาศที่เหมาะสมโดยเร็วที่สุด คุณสามารถเรียกข้อมูลแคมเปญที่ไม่มีการประกาศได้โดยใช้คําค้นหา GAQL ต่อไปนี้โดยใช้วิธี Search หรือ SearchStream ของ GoogleAdsService 

select campaign.id, campaign.contains_eu_political_advertising
  from
    campaign
  where
    campaign.contains_eu_political_advertising NOT IN
    (
       'CONTAINS_EU_POLITICAL_ADVERTISING',
       'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING'
    )

ฉันต้องทำอะไรบ้าง

หากแอปพลิเคชันใช้ Google Ads API หรือสคริปต์ Google Ads เพื่อสร้างหรือจัดการแคมเปญ โปรดอัปเดตแอปพลิเคชันเพื่อจัดการการบังคับใช้เหล่านี้ก่อนวันที่ 3 กันยายน 2025

ฉันจะขอความช่วยเหลือได้อย่างไร

โปรดติดต่อช่องทางการสนับสนุน Google Ads API หรือการสนับสนุนสคริปต์ Google Ads หากมีคำถามเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้

ภาพบุคคลของผู้เขียน - , ทีม Google Ads API

ป้ายกำกับ: campaign, google-ads-api, google-ads-scripts