2025 年 8 月 7 日，星期四
異動詳情
Google 已於去年公告，會在 2025 年 10 月新法規生效前停止於歐盟地區放送政治廣告。Google Ads API 和 Google Ads 指令碼將於 2025 年 9 月 3 日實施與這項異動相關的強制措施。如果您使用上述任一產品建立或管理廣告活動，可能需要在 2025 年 9 月 3 日前更新應用程式，以因應這些違規處置。
API 支援歐盟政治廣告自主聲明
Google Ads API 和 Google Ads 指令碼已新增支援功能，可讓您自行聲明廣告活動是否含有歐盟政治廣告。請參閱這篇文章，瞭解歐盟政治廣告的定義。API 的 v19.2、v20.1 和 v21 版本在 Campaign 物件中包含名為 contains_eu_political_advertising 的新欄位.。可能的值及其含義如下表所示。
| 值 | 意義 |
CONTAINS_EU_POLITICAL_ADVERTISING
|
廣告活動含有歐盟政治廣告。 |
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
|
廣告活動不含歐盟政治廣告。 |
UNSPECIFIED
|
廣告活動缺少歐盟政治廣告自我聲明。 |
您可以使用 GoogleAdsService 的 Search 或 SearchStream 方法執行下列查詢，在 Google Ads API 中擷取廣告活動的自主聲明狀態。如果是 Google Ads 指令碼，請使用 AdsApp.search 或 AdsApp.report 方法。
select campaign.id, campaign.contains_eu_political_advertising from campaign
如果您使用 Google Ads API 用戶端程式庫，可能需要下載最新版程式庫，才能在 API 的 v19 和 v20 版中使用這項功能。
API 驗證和強制執行異動
2025 年 9 月 3 日起，Google Ads API 和 Google Ads 指令碼將在 API 的 v19 和 v20 版本中，強制執行下列檢查。
- 透過 Google Ads API 或 Google Ads 指令碼建立的所有新廣告活動，都應設定
contains_eu_political_advertising欄位。如果未設定這個欄位，使用CampaignService.MutateCampaigns建立新廣告活動的 API 呼叫會失敗，並傳回FieldError.REQUIRED錯誤。使用AdsApp.mutate或AdsApp.mutateAll方法建立廣告活動時，Google Ads 指令碼會強制執行這些檢查。 - 所有現有廣告活動都應先設定
contains_eu_political_advertising欄位，再嘗試變更廣告活動或廣告群組層級的proximity, location,或location_group指定目標。如果廣告活動尚未完成自主聲明，使用CampaignCriterionService.MutateCampaignCriteria方法建立或更新這些廣告活動條件的 API 呼叫將失敗，並傳回CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION錯誤。如果廣告活動尚未完成自我聲明，則使用AdGroupCriterionService.MutateAdGroupCriteria建立或更新這些廣告群組條件的 API 呼叫也會以類似方式失敗。Google Ads 指令碼會在使用AdsApp.mutate、AdsApp.mutateAll、AdsApp.Campaign.addProximity和AdsApp.Campaign.addLocation方法變更指定目標時，強制執行這些檢查。 - 這些違規處置也適用於其他可用來製作廣告活動的機制，例如執行批次工作，以及使用
GoogleAdsService.Mutate方法建立和更新實體。 - 如果實驗組草稿廣告活動缺少
contains_eu_political_advertising declaration，嘗試使用ExperimentService.ScheduleExperiment方法安排新實驗時，系統會擲回ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION錯誤。 - 如果您在 Google Ads 指令碼中使用大量上傳功能，請參閱產品說明文件，進一步瞭解這項異動需要對試算表範本進行哪些變更。
Google Ads API 第 21 版已強制執行這些檢查。
這對廣告活動放送有何影響？
如果廣告活動將 contains_eu_political_advertising 設為 true，聲明含有歐盟政治廣告，則自 2025 年 9 月 22 日.起，將停止在歐盟放送廣告。詳情請參閱說明中心。
未聲明的現有廣告活動目前不受影響。建議您盡快更新帳戶中的現有廣告活動，並加上適當的聲明。您可以使用 GoogleAdsService 的 Search 或 SearchStream 方法，透過下列 GAQL 查詢擷取未宣告的廣告活動。
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 指令碼建立或管理廣告活動，請務必在 2025 年 9 月 3 日前更新應用程式，以因應這些強制執行措施。
如何取得協助？
如果對這項異動有任何疑問，請透過 Google Ads API 支援或 Google Ads 指令碼支援管道與我們聯絡。
- Anash P. Oommen，Google Ads API 團隊