Zmiany w interfejsie Google Ads API i skryptach Google Ads mające na celu spełnienie wymogów rozporządzenia Unii Europejskiej w sprawie reklam politycznych

Czwartek, 7 sierpnia 2025 r.

Co się zmienia?

Jak ogłosiliśmy w zeszłym roku, Google przestanie wyświetlać reklamy polityczne w Unii Europejskiej przed wejściem w życie nowego rozporządzenia w październiku 2025 r. 3 września 2025 r. wprowadzimy w interfejsie Google Ads API i skryptach Google Ads egzekwowanie zasad związane z tą zmianą. Jeśli używasz którejś z tych usług do tworzenia kampanii lub zarządzania nimi, przed 3 września 2025 r.

Obsługa interfejsu API na potrzeby samodzielnej deklaracji dotyczącej reklam politycznych w UE

Interfejs Google Ads API i skrypty Google Ads obsługują teraz samodzielne deklarowanie, czy kampania zawiera reklamy polityczne w UE. Dowiedz się, jak definiujemy reklamę polityczną w UE tutaj. Wersje 19.2, 20.1 i 21 interfejsu API zawierają nowe pole o nazwie contains_eu_political_advertising w obiekcie Campaign.. Możliwe wartości i ich znaczenie znajdziesz w tabeli poniżej.

Wartość	Znaczenie
CONTAINS_EU_POLITICAL_ADVERTISING	Kampania zawiera reklamy polityczne w UE.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING	Kampania nie zawiera reklam politycznych w UE.
UNSPECIFIED	W kampanii brakuje samodzielnej deklaracji dotyczącej reklam politycznych w UE.

Stan samodzielnej deklaracji kampanii możesz sprawdzić w interfejsie Google Ads API, wykonując podane niżej zapytanie za pomocą metody Search lub SearchStream usługi GoogleAdsService. W przypadku skryptów Google Ads używaj metod AdsApp.search lub AdsApp.report.

select campaign.id, campaign.contains_eu_political_advertising from campaign

Jeśli używasz bibliotek klienta interfejsu Google Ads API, może być konieczne pobranie najnowszej wersji biblioteki, aby korzystać z tej funkcji w interfejsie API w wersjach 19 i 20.

Zmiany w zakresie weryfikacji i egzekwowania zasad dotyczących interfejsów API

3 września 2025 r. interfejs Google Ads API i skrypty Google Ads zaczną egzekwować te kontrole w wersjach 19 i 20 interfejsu API.

• Wszystkie nowe kampanie utworzone za pomocą interfejsu Google Ads API lub skryptów Google Ads powinny mieć ustawione pole contains_eu_political_advertising. Jeśli to pole nie jest ustawione, wywołanie interfejsu API w celu utworzenia nowej kampanii za pomocą CampaignService.MutateCampaigns zakończy się błędem FieldError.REQUIRED. Skrypty Google Ads będą przeprowadzać te kontrole podczas tworzenia kampanii za pomocą metod AdsApp.mutate lub AdsApp.mutateAll.
• Wszystkie dotychczasowe kampanie powinny mieć ustawione pole contains_eu_political_advertising, zanim spróbujesz zmienić kierowanie na proximity, location, lub location_group na poziomie kampanii lub grupy reklam. Jeśli kampania nie została zadeklarowana, wywołanie interfejsu API w celu utworzenia lub zaktualizowania tych kryteriów kampanii za pomocą metody CampaignCriterionService.MutateCampaignCriteria w przypadku dotychczasowych kampanii zakończy się błędem CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION . Wywołanie interfejsu API w celu utworzenia lub zaktualizowania tych kryteriów grupy reklam za pomocą AdGroupCriterionService.MutateAdGroupCriteria również zakończy się niepowodzeniem, jeśli kampania nie została zadeklarowana przez użytkownika. Skrypty Google Ads będą przeprowadzać te kontrole podczas próby zmiany kierowania za pomocą metod AdsApp.mutate, AdsApp.mutateAll, AdsApp.Campaign.addProximity i AdsApp.Campaign.addLocation.
• Te zasady dotyczą też innych mechanizmów, których możesz używać do tworzenia kampanii, np. uruchamiania zadań wsadowych i używania metody GoogleAdsService.Mutate do tworzenia i aktualizowania elementów.
• Próba zaplanowania nowego eksperymentu za pomocą metody ExperimentService.ScheduleExperiment spowoduje błąd ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION , jeśli w kampaniach eksperymentalnych w wersji roboczej brakuje contains_eu_political_advertising declaration.
• Jeśli korzystasz z funkcji przesyłania zbiorczego w skryptach Google Ads, zapoznaj się z dokumentacją usługi, aby dowiedzieć się więcej o zmianach w szablonie arkusza kalkulacyjnego, które są wymagane w ramach tej zmiany.

Te kontrole są już wymuszane w interfejsie Google Ads API w wersji 21.

Jak wpłynie to na wyświetlanie reklam z mojej kampanii?

Każda kampania, w której zadeklarowano wyświetlanie reklam politycznych w UE przez ustawienie contains_eu_political_advertising na true, przestanie wyświetlać reklamy w UE 22 września 2025 r.. Więcej informacji znajdziesz w Centrum pomocy.

Na razie nie będzie to miało wpływu na dotychczasowe kampanie bez deklaracji. Zalecamy jak najszybsze zaktualizowanie dotychczasowych kampanii na kontach przez dodanie odpowiedniej deklaracji. Kampanie bez deklaracji możesz pobrać za pomocą tego zapytania GAQL, używając metody Search lub SearchStream w 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'
    )

Co muszę zrobić?

Jeśli Twoja aplikacja używa interfejsu Google Ads API lub skryptów Google Ads do tworzenia kampanii lub zarządzania nimi, przed 3 września 2025 r. zaktualizuj ją, aby uwzględnić te zmiany.

Jak uzyskać pomoc?

Jeśli masz więcej pytań dotyczących tej zmiany, skontaktuj się z zespołem pomocy interfejsu Google Ads API lub zespołem pomocy skryptów Google Ads.

 – Anash P. Oommen, zespół ds. interfejsu Google Ads API

Etykiety: campaign, google-ads-api, google-ads-scripts