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 interfejsu API na koncie menedżera Google Ads. Za każdym razem, gdy wywołujesz interfejs API, wysyłasz token programisty jako część żądania, ustawiając nagłówek HTTP lub gRPC developer-token.
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, oraz środowisko, w którym możesz wywoływać interfejs API.
Gdy zarejestrujesz się, aby uzyskać token programisty, domyślnie możesz otrzymać dostęp na poziomie Eksplorator. Umożliwia to wywoływanie interfejsu API na kontach produkcyjnych, ale z pewnymi ograniczeniami. W niektórych przypadkach, gdy nie możemy automatycznie sprawdzić Twojego zgłoszenia o token programisty, możemy przyznać Ci dostęp na poziomie Konto testowe. Umożliwia to wywoływanie interfejsu API tylko na kontach testowych. Aby usunąć ograniczenia dotyczące poziomów dostępu eksploratora i konta testowego, musisz poprosić o poziom dostępu Podstawowy lub Standardowy dla swojego tokenu programisty. Gdy Twoje zgłoszenie o token programisty zostanie sprawdzone i zatwierdzone, otrzymasz odpowiedni poziom dostępu.
Czy potrzebujesz nowego tokena programisty?
To, czy należy zarejestrować się, aby uzyskać nowy token programisty, zależy od kilku czynników. Oto kilka najczęstszych sytuacji:
Scenariusz |
Dalsze kroki |
| Twoja firma nigdy wcześniej nie korzystała z interfejsu Google Ads API i chcesz tworzyć własne aplikacje | Zarejestruj się, aby uzyskać nowy token programisty. Więcej informacji |
| Twoja firma aktywnie korzystała lub korzysta z interfejsu Google Ads API | Google zwykle przyznaje 1 token programisty na firmę, więc jeśli Twoja firma korzysta już z interfejsu Google Ads API, powinna używać dotychczasowego tokena programisty. Więcej informacji |
| Twoja firma korzysta już z interfejsu Google Ads API, ale tworzy też nowy produkt lub narzędzie | Jeśli masz pewność, że nie możesz użyć dotychczasowego tokena programisty, to możesz poprosić o nowy, wyjaśniając w zgłoszeniu swój przypadek użycia. W pozostałej części tego przewodnika możesz używać dotychczasowego tokena programisty. 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 innej firmy lub usługi, 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 poprosić o token programisty?
O token programisty mogą poprosić zarówno firmy, jak i indywidualni deweloperzy. W tabeli poniżej znajdziesz podsumowanie informacji, które musisz podać podczas rejestracji, aby uzyskać token programisty.
| Jeśli jesteś | Podaj te informacje o deweloperze | Uwagi dodatkowe |
|---|---|---|
| Deweloperem reprezentującym Twoją firmę lub zespół ds. produktu | Nazwa firmy i adres URL Twojej firmy | Google zwykle przyznaje 1 token programisty na firmę, ale w poszczególnych przypadkach może zatwierdzić osobne tokeny programisty dla różnych narzędzi. |
| Deweloperem indywidualnym, który nie reprezentuje firmy | Jako nazwę firmy podaj Individual. Zamiast adresu URL firmy możesz podać adresy URL innych stron, np. profilu na GitHubie lub LinkedIn. |
Musisz mieć jakąś formę obecności w internecie i podać Google adres URL
który pomoże nam ocenić, co planujesz zrobić z interfejsem Google Ads API. Ogólne adresy URL
takie jak test.com i example.com nie są
akceptowane. |
Jak poprosić o 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 ubiegania się o token programisty. Jeśli to konto menedżera nie jest jeszcze połączone z innymi kontami, zalecamy umieszczenie go u góry hierarchii kont, aby ułatwić proces sprawdzania 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. Poproś o dostęp do interfejsu Google Ads API
Pamiętaj, że proces sprawdzania tokena programisty może potrwać. Więcej informacji.
W przeglądarce otwórz stronę https://ads.google.com/aw/apicenter. Jeśli pojawi się taka prośba, 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 przetworzyć Twojego zgłoszenia i je odrzucić.
Upewnij się, że podany adres e-mail do kontaktu w sprawie interfejsu API prowadzi do skrzynki odbiorczej, która jest regularnie sprawdzana. Podczas procesu sprawdzania zespół ds. zgodności z interfejsem API Google może skontaktować się z Tobą pod tym adresem e-mail, aby uzyskać dodatkowe informacje. Jeśli nie będziemy mogli się z Tobą skontaktować, Google może nie kontynuować rozpatrywania Twojego zgłoszenia.
Adres e-mail do kontaktu w sprawie interfejsu API możesz edytować w Centrum interfejsu API. Aktualizuj te informacje nawet po zakończeniu procesu zgłaszania, aby Google mogło wysyłać Ci ważne powiadomienia o usłudze.
Po zakończeniu procesu zgłaszania token programisty pojawi się w Centrum interfejsu API z jednym z tych wyników:
- Twój token programisty ma dostęp na poziomie Eksplorator i stan Zatwierdzony. Oznacza to, że Google mogło automatycznie sprawdzić i zatwierdzić Twoje zgłoszenie o token programisty z dostępem na poziomie eksploratora. Możesz zacząć wywoływać interfejs API na swoim koncie produkcyjnym lub testowym.
- Twój token programisty ma dostęp na poziomie Konto testowe i stan Oczekuje na zatwierdzenie. Oznacza to, że Google nie mogło automatycznie sprawdzić i zatwierdzić Twojego zgłoszenia o token programisty z dostępem na poziomie eksploratora. Możesz zacząć wywoływać interfejs API na kontach testowych. Po przeczytaniu tego przewodnika zachęcamy do zapoznania się z informacjami o tym, jak poprosić o dostęp na poziomie podstawowym.
Sprawdź, 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:
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.
Gdzie znaleźć token programisty
Jeśli masz token programisty, znajdziesz go na stronie Centrum interfejsu API na koncie menedżera Google Ads.