Każdy token programisty interfejsu Google Ads API ma przypisany poziom dostępu i „dozwolony użytek”. Poziom dostępu określa, czy możesz mieć wpływ na konta produkcyjne oraz liczbę operacji i żądań, które możesz wykonywać dziennie. Dozwolone użycie określa konkretne funkcje interfejsu Google Ads API, z których może korzystać token dewelopera.
Poziomy dostępu
W tabeli podano trzy różne poziomy dostępu. Jeśli nie masz jeszcze dostępu do interfejsu Google Ads API, możesz zacząć od rejestracji, aby uzyskać dostęp do konta testowego. Możesz zwiększyć poziom dostępu, wykonując dodatkowe czynności w aplikacji.
| Poziom dostępu | Ma dostęp... | Dzienny limit operacji1 | Zastosuj |
|---|---|---|---|
| Sprawdź dostęp do konta | Konta testowe | 15 000 operacji / dzień | Instrukcje |
| Dostęp podstawowy | Konta testowe i produkcyjne | 15 000 operacji / dzień | Instrukcje |
| Dostęp standardowy | Konta testowe i produkcyjne | Nieograniczona liczba operacji dziennie | Instrukcje |
1 Wartość „dziennie” jest oparta na 24-godzinnym okresie, w którym żądania do interfejsu API były wysyłane przy użyciu Twojego tokena programisty. Jeśli w ciągu ostatnich 24 godzin aplikacja przekroczy limit żądań Twojego poziomu dostępu, otrzyma komunikat o błędzie.
Sprawdź dostęp do konta
Po wstępnej rejestracji w interfejsie Google Ads API otrzymasz token programisty z testowym poziomem dostępu do konta. Oznacza to, że token programisty może wysyłać żądania do interfejsu Google Ads API tylko z kont testowych.
Prośba o dostęp do konta testowego
Aby automatycznie uzyskać poziom dostępu do konta testowego, zarejestruj się w interfejsie internetowym Google Ads.
Dostęp podstawowy
Dostęp podstawowy umożliwia tokenowi programisty wysyłanie żądań do interfejsu Google Ads API zarówno do kont testowych, jak i produkcyjnych. Konta produkcyjne to konta, na których wyświetlane są prawdziwe, aktywne reklamy Google. Konta testowe nie wyświetlają reklam.
Podstawowy poziom dostępu umożliwia tokenowi programisty wykonywanie do 15 tys. operacji dziennie. W przypadku większości deweloperów to wystarczy.
Prośba o dostęp podstawowy
Jeśli masz obecnie token programisty na poziomie konta testowego i chcesz poprosić o dostęp do konta w wersji produkcyjnej, wypełnij podstawowy formularz wniosku o dostęp. Upewnij się, że wykonane zostały te czynności:
- Sprawdź, czy masz już token programisty z poziomem dostępu do konta testowego.
- Sprawdź, czy kontaktowy adres e-mail osoby kontaktowej ds. interfejsu API w Centrum interfejsów API jest aktualny. Nie możesz ukończyć procesu zgłaszania bez prawidłowego, regularnie sprawdzanego adresu e-mail. Sprawdź, czy wszystkie aktywne konta Google Ads są połączone z kontem menedżera za pomocą tokena API.
Dostęp standardowy
Dostęp standardowy umożliwia tokenowi programisty wykonywanie nieograniczonej liczby operacji dziennie w większości usług. Obejmuje to m.in. GoogleAdsService Search i SearchStream. Więcej informacji o limitach i wyjątkach od dostępu standardowego znajdziesz w artykule Limity interfejsu API.
Standardowy poziom dostępu jest przyznawany tylko tym deweloperom, którzy wymagają nieograniczonej liczby operacji związanych z interfejsem Google Ads API, np. dużym firmom lub narzędziom obsługującym wielu użytkowników.
Bez względu na poziom dostępu wszystkie operacje interfejsu API podlegają limitom systemowym. Więcej informacji o postępowaniu z błędami dotyczącymi limitu liczby żądań znajdziesz w sekcji Typy błędów.
Prośba o dostęp standardowy
Jeśli obecnie masz podstawowy poziom dostępu i chcesz poprosić o możliwość korzystania z nieograniczonej liczby operacji w interfejsie Google Ads API, wypełnij standardowy formularz zgłoszeniowy.
Jeśli używasz narzędzia zewnętrznego, przygotuj mu dostęp w wersji demonstracyjnej do logowania. Pamiętaj, że narzędzie musi spełniać wymagania dotyczące minimalnej funkcjonalności.
Dozwolone użytkowanie
Dozwolone użycie dotyczy tylko podstawowych i standardowych tokenów dostępu. Dozwolone zastosowania są przydzielane na podstawie planowanego użycia interfejsu Google Ads API. Te uprawnienia określają, dla których funkcji interfejsu API można użyć tokena, jak zostało omówione w tej tabeli:
| Dozwolone użytkowanie | Opis |
|---|---|
| Tworzenie reklam i zarządzanie nimi | Zapewnia dostęp do wszystkich usług interfejsu API służących do tworzenia kampanii, grup reklam, reklam i słów kluczowych w Google Ads oraz zarządzania nimi. |
| Zdawanie relacji | Wykonuj tylko żądania GoogleAdsService.Search lub GoogleAdsService.SearchStream albo połączenia tylko do odczytu. Ta opcja jest przeznaczona dla deweloperów, którzy używają interfejsu API tylko do wysyłania żądań statystyk.
|
| Analizowanie słów kluczowych i rekomendacji | Zezwól tokenowi na dostęp do RecommendationService, KeywordPlanIdeaService i KeywordPlanService. Jest on używany tylko w przypadku narzędzi wymagających sugestii, które ułatwiają tworzenie kampanii Google Ads i zarządzanie nimi. |
Zmiana dozwolonego użycia
Jeśli uzyskasz dostęp podstawowy lub standardowy, możesz przesłać prośbę o zaktualizowanie dozwolonego użycia. Wypełnij wniosek, jeśli chcesz zmienić dozwolone wykorzystanie Twojego narzędzia lub przyznać klientom dostęp do swojego narzędzia.