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 programisty, domyślnie możesz otrzymać poziom Explorer Access. Umożliwia to wykonywanie wywołań na kontach produkcyjnych, ale z pewnymi ograniczeniami. W niektórych przypadkach, gdy nie możemy automatycznie sprawdzić Twojego zgłoszenia o token dewelopera, możemy przyznać mu poziom dostępu Test Account Access. Umożliwia to wywoływanie interfejsu API tylko na kontach testowych. Aby usunąć ograniczenia poziomów dostępu konta eksploracyjnego i testowego, musisz poprosić o poziom Podstawowy dostęp lub Standardowy dostęp dla tokena dewelopera. Gdy Twoje zgłoszenie o przyznanie tokena 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żywać 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. |
Kto może ubiegać się o token programisty?
O token programisty mogą się ubiegać zarówno firmy, jak i indywidualni deweloperzy. W tabeli poniżej znajdziesz podsumowanie informacji, które musisz podać podczas rejestracji tokena dewelopera.
| Jeśli | Następnie podaj te informacje o deweloperze: | Uwagi dodatkowe |
|---|---|---|
| deweloper reprezentujący Twoją firmę lub zespół produktu; | nazwę i adres URL firmy, | Google zwykle przyznaje 1 token dewelopera na firmę, ale w przypadku oddzielnych narzędzi może przyznać osobne tokeny dewelopera. |
| Deweloper indywidualny, który nie reprezentuje firmy | Podaj nazwę firmy w formacie Individual. Zamiast adresu URL firmy możesz podać alternatywne adresy URL, np. adres URL profilu GitHub lub LinkedIn. |
Musisz mieć jakąś formę obecności w internecie i przesłać do Google adres URL, który pomoże nam ocenić, co zamierzasz robić za pomocą interfejsu Google Ads API. Ogólne adresy URL, takie jak test.com i example.com, nie są akceptowane. |
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 programisty. 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.
Sprawdź, czy 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 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 przesyłać Ci ważne powiadomienia o usługach.
Po zakończeniu procesu składania wniosku token programisty pojawi się w Centrum interfejsu API z jednym z tych wyników:
- Twój token programisty ma poziom Explorer Access ze stanem Approved. Oznacza to, że Google mogło automatycznie sprawdzić i zatwierdzić Twoją prośbę o token dewelopera na poziomie dostępu Explorer. Możesz zacząć wywoływać interfejs API na koncie produkcyjnym lub koncie testowym.
- Twój token dewelopera ma poziom dostępu Dostęp do konta testowego i stan Oczekuje na zatwierdzenie. Oznacza to, że nie udało nam się automatycznie sprawdzić i zatwierdzić Twojego zgłoszenia o token dewelopera na poziomie dostępu Explorer. Możesz zacząć wywoływać interfejs API na kontach testowych. Po przeczytaniu tego przewodnika zachęcamy do zapoznania się z informacjami o tym, jak ubiegać się o poziom dostępu podstawowego.
Sprawdzanie, czy jesteś zalogowany(-a) na konto menedżera Google Ads
Aby uzyskać dostęp do tokena programisty, musisz zalogować się na konto menedżera Google Ads. Nie może to być testowe konto menedżera Google Ads.
Aby sprawdzić, czy jesteś zalogowany(-a) na konto menedżera Google Ads, wykonaj te czynności:
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 testowego menedżera lub testowego reklamodawcy.
Gdzie znaleźć token dewelopera
Token programisty, jeśli istnieje, znajdziesz na stronie Centrum API na koncie menedżera Google Ads.
Dostęp do Centrum interfejsów API