Token programisty to 22-znakowy ciąg alfanumeryczny, który służył do łączenia aplikacji z interfejsem Google Ads API. Tokeny programisty zostały wycofane 9 września 2026 r. W tym przewodniku znajdziesz podsumowanie zmian i listę najczęstszych pytań dotyczących tej migracji, które pomogą obecnym deweloperom.

Co się zmienia?

W ramach wycofania tokenów programisty wprowadziliśmy kilka zmian w procesie wdrażania interfejsu Google Ads API i zarządzania dostępem do niego. W tej sekcji opisujemy najważniejsze zmiany.

Poziomy dostępu do interfejsu API są powiązane z projektami Google Cloud

9 września 2026 r. wycofaliśmy tokeny programisty. Na podstawie niedawnej aktywności w interfejsie API Twój obecny i aktywny poziom dostępu za pomocą tokena programisty został automatycznie przeniesiony do Twoich projektów Google Cloud. Możesz nadal wysyłać tokeny programisty w nagłówkach wywołań interfejsu API, ale jest to opcjonalne i serwery interfejsu API będą je ignorować. Twój dotychczasowy kod będzie nadal działać bez żadnych zmian. Poziomy dostępu do interfejsu API są teraz określane przez projekt w chmurze Google Cloud, którego używasz do generowania danych logowania OAuth.

• Jeśli Twoja aplikacja korzysta z procesu uwierzytelniania użytkownika, jest to projekt, który jest właścicielem identyfikatora klienta OAuth i tajnego klucza.
• Jeśli używasz procesu konta usługi, jest to projekt, który jest właścicielem Twojego konta usługi.

Nowy proces rejestracji w interfejsie Google Ads API

Teraz możesz zarejestrować się, aby uzyskać dostęp do interfejsu Google Ads API bezpośrednio w konsoli Google Cloud bez konieczności posiadania konta menedżera Google Ads. Nie rejestruj się, aby uzyskać token programisty, na stronie Centrum interfejsu API ani nie próbuj uzyskać dostępu do interfejsu API na stronie Centrum interfejsu API na koncie menedżera Google Ads, ponieważ te procesy zostały przeniesione do konsoli Google Cloud i nie będą przetwarzane, jeśli zostaną zainicjowane na stronie Centrum interfejsu API.

Nowy sposób zarządzania dostępem do interfejsu API

Wycofaliśmy wszystkie nowe funkcje rejestracji i zarządzania dostępem do interfejsu API, takie jak ubieganie się o dostęp do interfejsu API i zarządzanie poziomami dostępu do interfejsu API na stronie Centrum interfejsu API na kontach menedżera Google Ads. Te funkcje są teraz dostępne na stronie Przegląd interfejsu Google Ads API w konsoli Google Cloud.

Nadal możesz przejść na stronę Centrum interfejsu API, aby sprawdzić historię informacji o deweloperze. W przyszłości ta strona zostanie całkowicie wycofana.

Nowe kody błędów

Wersja 25 interfejsu Google Ads API zgłosi błąd CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION, jeśli spróbujesz użyć projektu w chmurze Google z poziomem dostępu Konto testowe do wywoływania konta produkcyjnego. Starsze wersje interfejsu API zwrócą zamiast tego błąd ACTION_NOT_PERMITTED. Jeśli wystąpi ten błąd, otwórz stronę Przegląd interfejsu Google Ads API w projekcie Google Cloud i poproś o dostęp do Eksploratora.

W przypadku dostępu podstawowego i standardowego wymagana jest weryfikacja marki

W przypadku nowych aplikacji z dostępem podstawowym i standardowym musisz przejść weryfikację marki w projekcie Google Cloud. Obecni użytkownicy nie muszą przechodzić weryfikacji marki, ale zachęcamy ich do tego.

Aplikacje z dostępem podstawowym są teraz zautomatyzowane i zostaną sprawdzone w ciągu kilku minut po weryfikacji marki i przesłaniu.

Ze względu na te aktualizacje procesu wszystkie oczekujące aplikacje z dostępem podstawowym do interfejsu API zostaną zamknięte w ramach tej zmiany. Osoby, których to dotyczy, otrzymają e-maila ze szczegółami i powinny ponownie poprosić o dostęp do interfejsu API na stronie Przegląd interfejsu Google Ads API page.

Nowe adresy e-mail do kontaktu w sprawie interfejsu API

W ramach przygotowań do wycofania strony Centrum interfejsu API będziemy używać listy właścicieli i redaktorów w Twoim projekcie Google Cloud jako jedynego kanału komunikacji administracyjnej i obowiązkowej zgodności. Aby zapewnić płynne przejście, tymczasowo będziemy nadal wysyłać obowiązkowe powiadomienia o usłudze na adres e-mail podany w Centrum interfejsu API. Będziemy Cię informować o postępach w procesie przechodzenia na nowe kanały komunikacji.

Co zrobić, jeśli jesteś obecnym deweloperem

Sprawdź poziomy dostępu do interfejsu API w projekcie Google Cloud: jeśli jesteś obecnym deweloperem, zachęcamy Cię do sprawdzenia strony Przegląd interfejsu Google Ads API w projektach Google Cloud, aby upewnić się, że mają one ten sam poziom dostępu do interfejsu API co Twój dotychczasowy token programisty. Aby rozwiązać ewentualne rozbieżności, postępuj zgodnie z instrukcjami w tym przewodniku.

Sprawdź adres e-mail do kontaktu w sprawie interfejsu API: otwórz stronę Uprawnienia w projekcie Google Cloud. Sprawdź, czy aktywni deweloperzy reklam i menedżerowie kont mają przypisane odpowiednie role właściciela lub redaktora w projekcie Google Cloud. Na te adresy e-mail będziemy wysyłać obowiązkowe powiadomienia o usłudze, aby informować Cię o przyszłych zmianach w interfejsie Google Ads API. Przez pewien czas będziemy nadal wysyłać obowiązkowe powiadomienia o usłudze na adres e-mail do kontaktu podany w Centrum interfejsu API. Będziemy Cię informować o wszelkich zmianach w tym procesie.

Popraw kod aplikacji: zachęcamy do zaktualizowania aplikacji, aby nie wysyłała tokena programisty w ramach wywołań interfejsu API. Opublikowaliśmy zaktualizowane wersje bibliotek klienta, serwera Google Ads MCP i Asystenta dewelopera interfejsu Google Ads API, które umożliwiają wywoływanie interfejsu API bez ustawiania tokena programisty. W przyszłej głównej wersji interfejsu Google Ads API zaczniemy odrzucać tokeny programisty w wywołaniach interfejsu API. Jeśli Twoja aplikacja korzysta z tych bibliotek, zaktualizuj zależności aplikacji, aby używać najnowszej wersji.

Jeśli potrzebujesz dodatkowej pomocy lub masz więcej pytań, skontaktuj się z zespołem pomocy interfejsu Google Ads API.

Najczęstsze pytania

Co się stanie z poziomami dostępu do interfejsu API?

Poziomy dostępu do interfejsu API są nadal egzekwowane w interfejsie Google Ads API. Są one jednak teraz przyznawane projektowi w konsoli Google Cloud, a nie tokenowi programisty. Gdy wykonujesz wywołania interfejsu API, Twoje poziomy dostępu do interfejsu API są teraz określane przez projekt Google Cloud , którego używasz do generowania danych logowania OAuth.

• Jeśli Twoja aplikacja korzysta z procesu uwierzytelniania użytkownika, jest to projekt, który jest właścicielem identyfikatora klienta OAuth i tajnego klucza.
• Jeśli używasz procesu konta usługi, jest to projekt, który jest właścicielem Twojego konta usługi.

Jak zidentyfikowano projekty do przeniesienia poziomów dostępu do interfejsu API?

Jeśli przed 9 września 2026 r. miałeś(-aś) zatwierdzony token programisty, jego poziomy dostępu zostały przeniesione do Twoich projektów Google Cloud w ten sposób:

• Przeanalizowaliśmy dzienniki wywołań interfejsu API z ostatnich 90 dni, aby określić, które projekty Cloud były używane do wywoływania interfejsu API za pomocą zatwierdzonego tokena programisty.
• Przypisaliśmy poziomy dostępu do interfejsu API tokena programisty do wszystkich zidentyfikowanych projektów Cloud.

Czy po tej zmianie mogę mieć kilka projektów Cloud z różnymi poziomami dostępu?

Tak, możesz mieć kilka projektów Google Cloud z różnymi poziomami dostępu do interfejsu API. Możesz na przykład mieć 1 projekt Google Cloud z dostępem podstawowym i inny projekt Google Cloud z dostępem standardowym.

Przykład

Załóżmy, że masz 4 tokeny programisty i 6 projektów Cloud z tymi informacjami:

• Token programisty 1: abcdefghijkl1234567890 ma dostęp standardowy. Był używany z identyfikatorami projektów: 1234567890, 5678912345, 45678912345.
• Token programisty 2: xyzabcdefghi6789012345 ma dostęp podstawowy. Był używany z identyfikatorem projektu: 1231235678.
• Token programisty 3: asdfgflkjhjz7654321012 ma dostęp podstawowy, ale nigdy nie był używany do wywoływania interfejsu API. Został niedawno zatwierdzony.
• Token programisty 4: qwertypoiuyu6543298790 miał dostęp standardowy, ale nie był używany w ciągu ostatnich 90 dni. W przeszłości z tym tokenem programisty był używany identyfikator projektu 9876564900.
• Projekt w chmurze: identyfikator projektu w chmurze: 7171234567 nigdy nie był używany z żadnym tokenem programisty do wywołania interfejsu API.

Poziomy dostępu do interfejsu API zostaną przeniesione z tokenów programisty do projektów Google Cloud w ten sposób:

Token programisty	Identyfikator projektu	Poziom dostępu	Wyjaśnienie
abcdefghijkl1234567890	1234567890	Dostęp standardowy	Token programisty i identyfikator projektu są ze sobą powiązane.
abcdefghijkl1234567890	5678912345	Dostęp standardowy	Token programisty i identyfikator projektu są ze sobą powiązane.
abcdefghijkl1234567890	45678912345	Dostęp standardowy	Token programisty i identyfikator projektu są ze sobą powiązane.
xyzabcdefghi6789012345	1231235678	Dostęp podstawowy	Token programisty i identyfikator projektu są ze sobą powiązane.
asdfgflkjhjz7654321012	--	--	Dostęp do interfejsu API tokena programisty nie został przeniesiony do żadnego projektu ponieważ token nigdy nie był używany do wywoływania interfejsu API.
qwertypoiuyu6543298790	9876564900	Dostęp do konta testowego	Dostęp do interfejsu API tokena programisty został cofnięty z powodu braku aktywności przez 90 dni. Poziom dostępu do interfejsu API projektu jest domyślnie ustawiony na dostęp do konta testowego.
--	7171234567	Dostęp do konta testowego	Jest to nowy projekt, który nie był używany z żadnym tokenem programisty. Poziom dostępu do interfejsu API projektu jest domyślnie ustawiony na dostęp do konta testowego.

Mam więcej niż 1 zatwierdzony token programisty. Do którego projektu przeniesiesz poziomy dostępu do interfejsu API?

Poziomy dostępu każdego zatwierdzonego tokena programisty zostaną przeniesione do projektów Google Cloud powiązanych z tym tokenem. Zobacz an przykład.

Używam kilku projektów Google Cloud. Do którego projektu przeniesiesz poziomy dostępu do interfejsu API?

Jeśli w ciągu ostatnich 90 dni używałeś(-aś) kilku projektów Google Cloud z zatwierdzonym tokenem programisty, wszystkie te projekty otrzymają te same poziomy dostępu do interfejsu API co Twój token programisty. Zobacz przykład.

Poziomy dostępu do interfejsu API zostały przypisane do projektu, którego już nie używam. Jak rozwiązać ten problem?

Jeśli dostęp do interfejsu Google Ads API jest przypisany do projektu w chmurze Google, którego już nie używasz, nie musisz podejmować żadnych dodatkowych działań. Po 90 dniach braku aktywności Google cofnie dostęp do interfejsu API w przypadku nieużywanego projektu.

Poziomy dostępu do interfejsu API nie zostały przypisane do mojego projektu w chmurze Google. Jak rozwiązać ten problem?

Twój projekt w Google Cloud nie odziedziczył poziomu dostępu tokena programisty prawdopodobnie dlatego, że nigdy nie używałeś(-aś) tokena programisty i projektu w chmurze do wywoływania interfejsu API lub dostęp do interfejsu API tokena programisty wygasł niedawno z powodu braku aktywności. Aby rozwiązać ten problem, poproś o odpowiedni poziom dostępu do interfejsu API w przypadku tego projektu na stronie Przegląd interfejsu Google Ads API page. Zobacz przykład.

Gdzie mogę sprawdzić poziomy dostępu do interfejsu API w moim projekcie?

Poziom dostępu do interfejsu API w projekcie Google Cloud możesz sprawdzić na stronie Przegląd interfejsu Google Ads API.

Jak poprosić o wyższe poziomy dostępu do interfejsu API?

Możesz poprosić o wyższe poziomy dostępu do interfejsu API w projekcie Google Cloud na stronie Przegląd interfejsu Google Ads API.

Co się stanie z moją oczekującą prośbą o dostęp do interfejsu API?

Wszystkie oczekujące prośby o dostęp podstawowy, które zostały zainicjowane w Centrum interfejsu API na koncie menedżera Google Ads przed 9 września 2026 r., zostaną zamknięte. Powinieneś(-aś) ponownie poprosić o dostęp podstawowy na stronie Przegląd interfejsu Google Ads API w projekcie Google Cloud. Jeśli ta zmiana Cię dotyczy, otrzymasz e-maila z odpowiednimi instrukcjami.

Wszystkie oczekujące prośby o dostęp standardowy, które zostały zainicjowane w Centrum interfejsu API na koncie menedżera Google Ads 9 września 2026 r., zostaną sprawdzone jak zwykle. Jeśli prośba zostanie zatwierdzona, projekt Google Cloud powiązany z Twoim tokenem programisty otrzyma dostęp standardowy.

Czy mogę ponownie powiązać zatwierdzony token programisty z nowym projektem Google Cloud?

W przeszłości zespół interfejsu Google Ads API obsługiwał ponowne powiązanie tokena programisty z nowym projektem w chmurze Google w indywidualnych przypadkach. Od 9 września 2026 r. nie jest to już możliwe, ponieważ wycofaliśmy tokeny programisty. Jeśli musisz użyć nowego projektu w chmurze Google, poproś o odpowiedni dostęp do interfejsu API na stronie Przegląd interfejsu Google Ads API w projekcie w chmurze Google.

Mam zatwierdzony token programisty, ale nigdy go nie użyłem(-am). Czy mogę używać tego tokena programisty?

Nie, nie możesz używać tego tokena programisty. Możliwe są 2 sytuacje:

1. Dostęp do tokena programisty może zostać cofnięty z powodu braku aktywności: zgodnie z zasadami Google możemy cofnąć Twój token interfejsu API, jeśli nie będziesz go używać przez 90 kolejnych dni. Jeśli od dłuższego czasu nie używasz tokena programisty, prawdopodobnie jego poziomy dostępu zostały cofnięte z powodu braku aktywności. W takim przypadku ponownie poproś o dostęp do interfejsu API w projekcie Google Cloud na stronie Przegląd interfejsu Google Ads API. Zobacz przykład.

2. Twój token programisty został niedawno zatwierdzony, ale nie był używany przed 9 września 2026 r.: ponieważ przed 9 września 2026 r. nie używałeś(-aś) zatwierdzonego tokena programisty z projektem Google Cloud, jego poziomy dostępu nie zostały przeniesione do projektu Cloud. W związku z tym nie możesz już używać tokena programisty. Jeśli spróbujesz wywołać interfejs API na koncie produkcyjnym za pomocą tego tokena programisty, zgłosimy błąd CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION. Aby rozwiązać ten błąd, poproś o odpowiedni dostęp do interfejsu API na stronie Przegląd interfejsu Google Ads API w projekcie Google Cloud. Zobacz an przykład.

W obu tych przypadkach możesz poprosić o dostęp do Eksploratora i dostęp podstawowy, a Twoje prośby zostaną sprawdzone automatycznie. Nie musisz już współpracować z zespołem ds. zgodności Google, aby zakończyć proces sprawdzania. Jeśli potrzebujesz dostępu standardowego, musisz przejść ręczne sprawdzenie. Podczas ubiegania się o dostęp standardowy możesz jednak udostępnić szczegóły zatwierdzonego tokena programisty, aby zespół ds. zgodności mógł odpowiednio sprawdzić Twoją nową prośbę o dostęp standardowy.

Czy mogę przestać wysyłać tokeny programisty w ramach żądań interfejsu API?

Tak, możesz przestać wysyłać tokeny programisty w ramach żądań interfejsu API. Jeśli używasz biblioteki klienta, być może musisz ją zaktualizować do najnowszej wersji. Sprawdź dzienniki zmian biblioteki, aby potwierdzić, czy obsługuje ona wywoływanie interfejsu API bez podawania tokena programisty.

Uczestniczyłem(-am) w programie pilotażowym dotyczącym poziomu dostępu zarządzanego w chmurze. Jak to na mnie wpłynie?

Program pilotażowy dotyczący poziomu dostępu zarządzanego w chmurze został wprowadzony, aby umożliwić deweloperom Google Cloud wywoływanie interfejsu API bez wysyłania tokena programisty w ramach żądania interfejsu API. Teraz, gdy wycofaliśmy tokeny programisty, ten program zostanie zakończony.

Poziomy dostępu aktywnego tokena programisty zostały przeniesione do Twojego projektu w chmurze Google, więc Twój dotychczasowy kod powinien nadal działać bez żadnych zmian. Jeśli musisz użyć nowego projektu w chmurze Google, poproś o dostęp do interfejsu API na stronie Przegląd interfejsu Google Ads API w projekcie w chmurze Google.

Mój token programisty był na liście dozwolonych. Jak to na mnie wpłynie?

Google może prowadzić programy pilotażowe, które zapewniają niektórym deweloperom dostęp do funkcji eksperymentalnych. Dostęp do tych funkcji jest czasami przyznawany przez dodanie tokena programisty do listy dozwolonych. Jeśli uczestniczyłeś(-aś) w takim programie pilotażowym, nie musisz podejmować żadnych działań.

Zaktualizowaliśmy wszystkie programy pilotażowe, aby zamiast tokenów programisty używały projektów Google Cloud jako mechanizmu dodawania do listy dozwolonych, i przenieśliśmy stan tokena programisty na liście dozwolonych do powiązanych projektów Google Cloud. Twój dotychczasowy kod powinien nadal działać bez żadnych zmian. Jeśli nadal masz problemy, skontaktuj się z opiekunem klienta w Google, który zarejestrował Cię w programie pilotażowym.

Mam zatwierdzony token programisty i chcę go używać z nowym projektem Google Cloud. Czy jest to dozwolone?

Nie, nie możesz używać nowego projektu Google Cloud z zatwierdzonym tokenem programisty. Ponieważ przed 9 września 2026 r. nie używałeś(-aś) zatwierdzonego tokena programisty z nowym projektem Google Cloud, jego poziomy dostępu nie zostały przeniesione do projektu Cloud. Jeśli spróbujesz wywołać interfejs API za pomocą tego tokena programisty, zgłosimy błąd CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION, ponieważ tokeny programisty nie są już używane do określania poziomów dostępu do interfejsu API. Aby rozwiązać ten błąd, poproś o odpowiedni dostęp do interfejsu API na stronie Przegląd interfejsu Google Ads API w projekcie Google Cloud. Zobacz przykład.

Mój token programisty wyciekł na zewnątrz. Czy muszę zresetować token programisty?

Nie, w tym przypadku nie musisz resetować tokena programisty. Ponieważ przenieśliśmy poziomy dostępu do interfejsu API tokena programisty do Twojego projektu w chmurze Google, nieautoryzowany użytkownik nie może już używać Twojego tokena programisty z własnym projektem w chmurze Google. Jeśli jednak wolisz, możesz zresetować token programisty w Centrum interfejsu API.

Co się stanie z Centrum interfejsu API?

Obecna strona Centrum interfejsu API na koncie menedżera Google Ads jest wycofana i wkrótce zostanie usunięta. Jeśli masz już token programisty, nadal możesz zalogować się na konto menedżera Google Ads i wyświetlić szczegóły. Służą one jednak tylko do celów informacyjnych. Nie wykonuj żadnych zadań związanych z poziomami dostępu tokena programisty, takich jak ubieganie się o wyższe poziomy dostępu do interfejsu API na tej stronie.

Jeśli musisz poprosić o wyższe poziomy dostępu do interfejsu API, zrób to na stronie Przegląd interfejsu Google Ads API w projekcie Google Cloud.

Czy nadal muszę mieć konto menedżera Google Ads, aby korzystać z interfejsu Google Ads API?

Aby korzystać z interfejsu Google Ads API, nie musisz już mieć konta menedżera Google Ads. Konto menedżera jest potrzebne tylko wtedy, gdy musisz połączyć się z wieloma kontami i nimi zarządzać za pomocą interfejsu API.

Jestem nowym deweloperem. Jak zarejestrować się w interfejsie Google Ads API?

Aby zarejestrować się w interfejsie Google Ads API, postępuj zgodnie z instrukcjami w przewodniku Pierwsze kroki. Nie rejestruj się, aby uzyskać token programisty, w Centrum interfejsu API na koncie menedżera Google Ads. Te prośby nie będą przetwarzane. Centrum interfejsu API zostanie wkrótce wycofane.