Token programisty to 22-znakowy ciąg alfanumeryczny, który umożliwia aplikacji łączenie się z interfejsem Google Ads API. Możesz go uzyskać, rejestrując się na stronie Centrum interfejsów API na koncie menedżera Google Ads. Za każdym razem, gdy wykonujesz wywołanie interfejsu API, wysyłasz token dewelopera w ramach żądania, ustawiając nagłówek developer-token HTTP lub gRPC.
Każdy token programisty ma przypisany poziom dostępu, który określa liczbę wywołań interfejsu API, jakie możesz wykonać dziennie za pomocą tokena, a także środowisko, do którego możesz wysyłać wywołania. Gdy zarejestrujesz się, aby uzyskać token dewelopera, domyślnie będzie on miał poziom Dostęp testowy. Umożliwia to wywoływanie interfejsu API tylko na kontach testowych. Aby wykonywać wywołania interfejsu API na koncie produkcyjnym, musisz poprosić o dostęp podstawowy lub dostęp standardowy dla tokena dewelopera. Gdy Twoje zgłoszenie o token dewelopera zostanie sprawdzone i zatwierdzone, token dewelopera otrzyma odpowiedni poziom dostępu.
Potrzebujesz nowego tokena dewelopera?
To, czy należy zarejestrować nowy token dewelopera, zależy od kilku czynników. Poniżej przedstawiono kilka najczęstszych sytuacji:
Scenariusz |
Dalsze kroki |
| Twoja firma nigdy wcześniej nie korzystała z interfejsu Google Ads API i chcesz opracować własne aplikacje. | Zarejestruj się, aby uzyskać nowy token programisty. Więcej informacji |
| Twoja firma aktywnie korzysta lub korzystała w przeszłości z interfejsu Google Ads API. | Zwykle przyznajemy 1 token programisty na firmę, więc jeśli Twoja firma korzysta już z interfejsu Google Ads API, użyj dotychczasowego tokena programisty. Więcej informacji |
| Twoja firma korzysta już z interfejsu Google Ads API, ale opracowuje też nowy produkt lub narzędzie. | Jeśli masz pewność, że nie możesz użyć obecnego tokena dewelopera, możesz złożyć wniosek o nowy token, wyjaśniając w nim swój przypadek użycia. W pozostałej części tego przewodnika możesz używać dotychczasowego tokena dewelopera. Więcej informacji |
| Twoja firma korzysta z aplikacji innej firmy | Token programisty jest potrzebny tylko wtedy, gdy tworzysz własną aplikację. Jeśli korzystasz z aplikacji lub usługi innej firmy, token programisty musi uzyskać deweloper tej aplikacji. Jeśli nie masz pewności, co zrobić w Twoim przypadku, skontaktuj się z zespołem ds. zgodności z interfejsem API. |
Jak zgłosić się po token programisty
Proces ubiegania się o token programisty składa się z 2 etapów.
Krok 1. Wybierz lub utwórz konto menedżera Google Ads
Jeśli masz już konto menedżera Google Ads, wybierz je podczas składania wniosku o token. Jeśli to konto menedżera nie jest jeszcze połączone z innymi kontami, zalecamy umieszczenie go u podstawy hierarchii kont, aby ułatwić proces weryfikacji tokena i uprościć zarządzanie kontami w przyszłości.
Jeśli nie masz konta menedżera, możesz je utworzyć, postępując zgodnie z instrukcjami w Centrum pomocy.
Krok 2. Zgłoś chęć dostępu do interfejsu Google Ads API
Pamiętaj, że proces weryfikacji tokena dewelopera może trochę potrwać. Więcej informacji
W przeglądarce otwórz stronę https://ads.google.com/aw/apicenter. W razie potrzeby zaloguj się na konto menedżera Google Ads.
Wypełnij formularz dostępu do interfejsu API i zaakceptuj Warunki korzystania z usługi.
Upewnij się, że informacje są prawidłowe, a adres URL witryny Twojej firmy działa. Jeśli witryna nie jest aktywna, Google może nie być w stanie rozpatrzyć Twojego zgłoszenia i może je odrzucić.
Upewnij się, że podany przez Ciebie kontaktowy adres e-mail API prowadzi do skrzynki odbiorczej, która jest regularnie sprawdzana. Zespół Google ds. zgodności z interfejsem API może skontaktować się z Tobą na ten adres e-mail w trakcie procesu weryfikacji, aby uzyskać wyjaśnienia. Jeśli nie będziemy mogli się z Tobą skontaktować, możemy nie kontynuować rozpatrywania Twojego zgłoszenia.
Adres e-mail kontaktu w sprawie interfejsu API możesz edytować w Centrum interfejsów API. Aktualizuj te informacje nawet po zakończeniu procesu rejestracji, aby Google mogło wysyłać Ci ważne powiadomienia o usługach.
Po zakończeniu procesu składania wniosku token programisty pojawi się w Centrum interfejsu API ze stanem Oczekuje na zatwierdzenie. Twój token dewelopera ma teraz poziom dostępu Test Account Access i możesz zacząć wywoływać interfejs API w kontach testowych.
Sprawdź, czy logujesz się na konto menedżera
Aby uzyskać dostęp do tokena programisty, musisz zalogować się na konto menedżera. Nie może to być testowe konto menedżera.
Aby sprawdzić, czy jesteś zalogowany(-a) na konto menedżera:
W przeglądarce otwórz stronę https://ads.google.com/aw/apicenter.
Jeśli zalogujesz się na konto klienta, na stronie pojawi się komunikat Centrum interfejsu API jest dostępne tylko na kontach menedżera.
Jeśli w prawym górnym rogu pojawi się na czerwono napis Konto testowe, oznacza to, że Twoje konto jest kontem menedżera testowego lub reklamodawcy testowego.
Gdzie znaleźć token dewelopera
Token programisty, jeśli istnieje, znajdziesz na stronie Centrum API na koncie menedżera Google Ads.