Google Ads API po zmianach z września 2026: dostęp przez Google Cloud i pierwsze raporty

Co zmieniło się w Google Ads API we wrześniu 2026

Najważniejsza zmiana dotyczy tego, kto i na jakich zasadach może korzystać z API. Wcześniej punktem wyjścia był token deweloperski przypisany do konta menedżera, a poziom dostępu zatwierdzano w Centrum API w Google Ads. Teraz punktem wyjścia jest projekt Google Cloud.

Dla istniejących integracji Google zapewnia ciągłość: dotychczasowy kod działa, a poziomy dostępu tokenów zostały przypisane do projektów Cloud na podstawie ostatniej aktywności. Nie oznacza to jednak, że nie trzeba nic robić. Mapowanie mogło trafić do innego projektu, niż się spodziewasz, zwłaszcza jeśli jedna firma używała kilku projektów do różnych narzędzi. Centrum API jest wygaszane etapami, a Google nie podał daty jego pełnego wyłączenia.

Zmiana dotyczy tylko API. Skrypty Google Ads działają po staremu i nie wymagają projektu Cloud ani tokena – piszemy o nich w artykule o 10 skryptach do monitorowania konta. W tym samym okresie Google ogłosił też ogólną dostępność Data Manager API (10 września 2026 roku) do przesyłania konwersji i list odbiorców, a 19 października zakończył wsparcie dla Google Ads Editor w wersji 2.10 i starszych.

Poziomy dostępu do Google Ads API: od testowego do standardowego

Poziom dostępu określa, na jakich kontach i z jakim limitem operacji może działać aplikacja. Struktura poziomów się nie zmieniła – zmieniło się to, gdzie są przypisane.

• Test Account Access – praca wyłącznie na kontach testowych. Próba odwołania się do konta produkcyjnego kończy się w wersji v25 błędem CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION, a w starszych wersjach błędem ACTION_NOT_PERMITTED.
• Explorer Access – ograniczony dostęp do kont produkcyjnych z niższym dziennym limitem operacji. Wniosek składasz na stronie przeglądu Google Ads API w konsoli Cloud. To dobry poziom na pierwsze raporty i prototypy.
• Basic Access – dostęp do kont produkcyjnych z dziennym limitem operacji, który w dokumentacji od lat wynosił 15 000; aktualne limity sprawdzisz na stronie przeglądu API. Nowe wnioski wymagają weryfikacji marki.
• Standard Access – dla narzędzi o dużej skali, bez dziennego limitu operacji (nadal obowiązują limity szybkości). Również wymaga weryfikacji marki.

Dla zespołu marketingu, który chce pobierać dane z kilkunastu kont do hurtowni lub dashboardu, zwykle wystarcza Basic Access. Explorer Access pozwala zacząć od razu, zanim zakończysz weryfikację marki.

Jak skonfigurować dostęp do Google Ads API przez Google Cloud krok po kroku

Poniższa procedura dotyczy nowej integracji. Jeśli masz już działające narzędzie, przejdź do punktów 5–8.

1. Utwórz osobny projekt Google Cloud dla integracji. Zasady obowiązujące od 31 sierpnia 2026 roku wymagają dedykowanego projektu dla każdej integracji. Nie mieszaj w jednym projekcie dashboardu, narzędzia do stawek i eksperymentów z AI.
2. Włącz Google Ads API w projekcie. W bibliotece interfejsów API konsoli Cloud znajdź Google Ads API i włącz je.
3. Skonfiguruj ekran zgody OAuth i utwórz klienta OAuth. Dla narzędzia wewnętrznego wystarczy aplikacja desktopowa lub internetowa z zakresem dostępu do Google Ads. Zapisz identyfikator i sekret klienta w menedżerze sekretów, nie w kodzie.
4. Wygeneruj token odświeżania. Zaloguj się kontem, które ma dostęp do kont Google Ads (bezpośrednio albo przez konto menedżera), i wykonaj przepływ OAuth. Token odświeżania pozwala aplikacji uzyskiwać krótkotrwałe tokeny dostępu.
5. Sprawdź poziom dostępu projektu. Na stronie przeglądu Google Ads API w konsoli Cloud zobaczysz przypisany poziom. Porównaj go z poziomem, który miał Twój token w Centrum API; jeśli się różni, złóż wniosek ponownie lub skontaktuj się z pomocą techniczną.
6. Złóż wniosek o wyższy poziom. Explorer Access zamówisz bezpośrednio na stronie przeglądu. Basic i Standard wymagają weryfikacji marki – przygotuj dane firmy i domenę.
7. Zaktualizuj biblioteki klienckie i przestań wysyłać token. Google opublikował nowe wersje bibliotek, które pozwalają pominąć token deweloperski. Przed aktualizacją sprawdź informacje o wydaniu dla swojego języka.
8. Uporządkuj uprawnienia IAM. Komunikaty obowiązkowe dotyczące API trafiają do właścicieli i edytorów projektu. Upewnij się, że są wśród nich aktywne adresy osób odpowiedzialnych za integrację.

Pierwszy raport: zapytanie GAQL przez REST i Apps Script

Najprostszy test dostępu to zapytanie do usługi googleAds:searchStream. Potrzebujesz tokena dostępu OAuth, identyfikatora konta (bez myślników) i – jeśli łączysz się przez konto menedżera – nagłówka login-customer-id z identyfikatorem MCC. Nagłówka developer-token już nie podajesz.

Krok 1 – wymiana tokena odświeżania na token dostępu:
curl -s -X POST https://oauth2.googleapis.com/token \
  -d client_id=TWOJ_CLIENT_ID -d client_secret=TWOJ_SECRET \
  -d refresh_token=TWOJ_REFRESH_TOKEN -d grant_type=refresh_token

Krok 2 – zapytanie GAQL (sprawdź aktualną wersję API w dokumentacji):
curl -s -X POST "https://googleads.googleapis.com/v25/customers/1234567890/googleAds:searchStream" \
  -H "Authorization: Bearer TWOJ_ACCESS_TOKEN" \
  -H "login-customer-id: 9876543210" \
  -H "Content-Type: application/json" \
  -d '{"query": "SELECT campaign.name, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_7_DAYS"}'

Odpowiedź to tablica paczek z wynikami, w których pola mają nazwy w notacji camelCase, a wartości liczbowe typu int64 są zwracane jako tekst:

[
  {
    "results": [
      {
        "campaign": { "resourceName": "customers/1234567890/campaigns/111", "name": "PL_Search_Brand" },
        "metrics": { "costMicros": "1843200000", "conversions": 57.0 }
      }
    ],
    "fieldMask": "campaign.name,metrics.costMicros,metrics.conversions"
  }
]

Koszt podawany jest w mikrojednostkach waluty konta, więc 1843200000 to 1843,20 zł. Jeśli wolisz rozwiązanie bez serwera, to samo zapytanie wyślesz z Apps Script. Projekt skryptu trzeba wtedy przełączyć w ustawieniach na standardowy projekt Google Cloud z włączonym Google Ads API, a w pliku manifestu dodać zakres dostępu do Google Ads.

// appsscript.json → "oauthScopes": [
//   "https://www.googleapis.com/auth/adwords",
//   "https://www.googleapis.com/auth/script.external_request",
//   "https://www.googleapis.com/auth/spreadsheets" ]
var WERSJA_API = 'v25';         // sprawdź aktualną wersję
var KONTO = '1234567890';       // ID konta bez myślników
var MCC = '9876543210';         // ID konta menedżera (lub usuń nagłówek)

function raportKampanii() {
  var query = "SELECT segments.date, campaign.name, metrics.clicks, metrics.cost_micros, " +
              "metrics.conversions, metrics.conversions_value FROM campaign " +
              "WHERE segments.date DURING LAST_7_DAYS AND campaign.status = 'ENABLED'";
  var odp = UrlFetchApp.fetch('https://googleads.googleapis.com/' + WERSJA_API + '/customers/' + KONTO + '/googleAds:searchStream', {
    method: 'post', contentType: 'application/json', muteHttpExceptions: true,
    headers: { Authorization: 'Bearer ' + ScriptApp.getOAuthToken(), 'login-customer-id': MCC },
    payload: JSON.stringify({ query: query })
  });
  if (odp.getResponseCode() !== 200) throw new Error(odp.getContentText());

  var wiersze = [['Data', 'Kampania', 'Kliknięcia', 'Koszt', 'Konwersje', 'Wartość konwersji']];
  JSON.parse(odp.getContentText()).forEach(function (paczka) {
    (paczka.results || []).forEach(function (r) {
      wiersze.push([r.segments.date, r.campaign.name, Number(r.metrics.clicks || 0),
                    Number(r.metrics.costMicros || 0) / 1e6, Number(r.metrics.conversions || 0),
                    Number(r.metrics.conversionsValue || 0)]);
    });
  });
  var ark = SpreadsheetApp.getActive().getSheetByName('api') || SpreadsheetApp.getActive().insertSheet('api');
  ark.clearContents().getRange(1, 1, wiersze.length, wiersze[0].length).setValues(wiersze);
}

Taki skrypt to dobry punkt wyjścia do raportów zespołowych. Gotowy przepływ z podsumowaniem na Slacku opisujemy w artykule o automatycznych raportach Google Ads.

Raporty, od których warto zacząć

GAQL daje dostęp do kilkuset zasobów, ale większość raportów marketingowych opiera się na kilku z nich. Poniższa lista wystarczy do zbudowania pierwszej hurtowni danych lub dashboardu.

Zasada, o której łatwo zapomnieć: segment użyty w warunku WHERE musi znaleźć się także w SELECT, z wyjątkiem segmentów daty. Zapytanie z filtrem segments.hour bez tego pola w SELECT zwróci błąd. Zasób change_event wymaga z kolei ograniczenia daty do ostatnich 30 dni i klauzuli LIMIT.

Jeśli dane mają trafiać do BigQuery, rozważ też gotowy transfer danych Google Ads w BigQuery – nie wymaga pisania kodu, a tabele mają stałą strukturę. Jak łączyć je z eksportem GA4, pokazujemy w tekście o zapytaniach do eksportu GA4 w BigQuery, a jak nie przepłacić za zapytania – w artykule o kosztach BigQuery.

Najczęstsze błędy po zmianie i jak je rozwiązać

Większość problemów po 10 września wynika z przypisania projektu i brakujących nagłówków, a nie z samego kodu.

• CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION (v25) lub ACTION_NOT_PERMITTED (starsze wersje). Projekt ma tylko dostęp testowy. Złóż wniosek o Explorer Access na stronie przeglądu API.
• USER_PERMISSION_DENIED. Najczęściej brakuje nagłówka login-customer-id przy dostępie przez konto menedżera albo konto OAuth nie ma uprawnień do wskazanego konta.
• Inny poziom dostępu niż wcześniej. Dane OAuth pochodzą z innego projektu, niż ten, do którego przypisano dotychczasowy poziom. Sprawdź identyfikator klienta OAuth i projekt, w którym go utworzono.
• Błędy limitów (RESOURCE_EXHAUSTED). Przekroczono limit operacji lub szybkości. Grupuj zapytania, korzystaj z searchStream zamiast wielu małych zapytań i dodaj ponawianie z rosnącym opóźnieniem.
• Brak komunikatów od Google. Na liście właścicieli i edytorów projektu nie ma aktywnych adresów. Zaktualizuj uprawnienia IAM.

API, skrypty czy gotowe łączniki: co wybrać

Google Ads API daje najwięcej możliwości, ale też wymaga najwięcej pracy: projektu Cloud, bezpiecznego przechowywania tokenów, obsługi wersji i limitów. Nie zawsze jest potrzebne.

Skrypty Google Ads wystarczą, gdy chcesz monitorować konto, wysyłać alerty i zapisywać dane w arkuszach – przykłady znajdziesz w tekście o skryptach wyłapujących anomalie w budżecie. Gotowe łączniki do Looker Studio lub transfer do BigQuery sprawdzą się w raportowaniu bez kodu. API wybierz, gdy budujesz własne narzędzie, łączysz dane z wielu kont i systemów albo chcesz, by model językowy pracował na danych z konta.

Ten ostatni scenariusz szybko zyskuje na popularności. Serwery MCP pozwalają połączyć asystentów AI z Google Ads przez API – opisujemy to w artykule o MCP w marketingu. Pamiętaj wtedy o zasadzie najmniejszych uprawnień: osobny projekt Cloud, dostęp tylko do odczytu tam, gdzie wystarczy, i jasne zasady dotyczące danych klientów, które omawiamy w tekście o danych klientów w narzędziach AI. Listy Customer Match i konwersje offline przesyłaj przez Data Manager, o czym piszemy w artykule o Customer Match i Data Manager.

Pozostałe poradniki o automatyzacji znajdziesz w podtemacie Skrypty i automatyzacja, a przegląd funkcji – na stronie narzędzia Google Ads.