Każdy token programisty interfejsu Google Ads API ma przypisany poziom dostępu i „dozwolone użycie”. Poziom dostępu określa, czy możesz wpływać na konta produkcyjne, oraz liczbę operacji i żądań, które możesz wykonywać codziennie. Dozwolone użycie określa, z których funkcji interfejsu Google Ads API można korzystać za pomocą tokena programisty.
Poziomy dostępu
W tabeli znajdziesz 3 poziomy dostępu. Jeśli nie masz jeszcze dostępu do interfejsu Google Ads API, zacznij od zarejestrowania się, aby uzyskać dostęp do konta testowego. Aby zwiększyć poziom dostępu, wykonaj dodatkowe czynności w aplikacji.
Poziom dostępu | Może uzyskać dostęp do | Limit operacji na dzień1 | Zastosuj |
---|---|---|---|
Testowanie dostępu do konta | Konta testowe | 15 000 operacji dziennie | Instrukcje |
Dostęp podstawowy | Konta testowe i produkcyjne | 15 000 operacji dziennie | Instrukcje |
Dostęp standardowy | Konta testowe i produkcyjne | Nieograniczona liczba operacji na dzień | Instrukcje |
1 „W ciągu dnia” to przesuwający się 24-godzinny okres, w którym wysyłane były żądania interfejsu API przy użyciu Twojego tokenu dewelopera. Jeśli aplikacja przekroczy limit żądań dla Twojego poziomu dostępu w ciągu ostatnich 24 godzin, otrzyma błąd.
Testowanie dostępu do konta
Po zakończeniu wstępnej rejestracji w Google Ads API otrzymasz token programisty z poziomem dostępu do konta testowego. Oznacza to, że token programisty może wysyłać żądania do interfejsu Google Ads API tylko na kontach testowych.
Prośba o dostęp do konta testowego
Aby automatycznie uzyskać poziom dostępu do konta testowego, w interfejsie internetowym Google Ads zarejestruj się do korzystania z Google Ads API.
Dostęp podstawowy
Dostęp podstawowy umożliwia tokenowi dewelopera wysyłanie żądań do interfejsu Google Ads API zarówno na kontach testowych, jak i produkcyjnych. Konta produkcyjne to wszystkie konta, na których wyświetlają się prawdziwe, aktywne reklamy Google. Na kontach testowych reklamy się nie wyświetlają.
Podstawowy poziom dostępu umożliwia tokenowi dewelopera wykonanie do 15 tys. operacji dziennie. W większości przypadków jest to wystarczające.
Prośba o podstawowy dostęp
Jeśli masz token dewelopera na poziomie dostępu do konta testowego i chcesz uzyskać dostęp do konta produkcyjnego, wypełnij formularz wniosku o podstawowy dostęp. Upewnij się, że wykonane zostały te czynności:
- Upewnij się, że masz już token programisty z poziomem dostępu konta testowego.
- Sprawdź, czy adres e-mail do kontaktu w sprawie interfejsu API w centrum interfejsu API jest aktualny. Aby wyświetlić Centrum interfejsu API, musisz zalogować się na konto menedżera. Bez ważnego, regularnie sprawdzanego adresu e-mail nie będzie można dokończyć procesu rejestracji. Upewnij się, że wszystkie aktywne konta Google Ads zostały połączone z kontem menedżera za pomocą tokena API.
Dostęp standardowy
Dostęp standardowy umożliwia tokenowi dewelopera wykonywanie nieograniczonej liczby operacji dziennie w przypadku większości usług. Obejmuje to między innymi:GoogleAdsService
Search
i SearchStream
. Więcej informacji o limitach i wyjątkach dotyczących standardowego dostępu znajdziesz w artykule Limity interfejsu API.
Standardowy poziom dostępu jest przyznawany tylko deweloperom, którzy potrzebują nieograniczonych operacji interfejsu Google Ads API, np. dużym firmom lub narzędziom obsługującym wielu użytkowników.
Niezależnie od poziomu dostępu wszystkie operacje interfejsu API podlegają ograniczeniom szybkości systemu. Więcej informacji o sposobach postępowania w przypadku błędów związanych z ograniczeniem szybkości znajdziesz w artykule Typy błędów.
Prośba o dostęp standardowy
Jeśli masz obecnie podstawowy poziom dostępu i chcesz ubiegać się o nieograniczone operacje interfejsu Google Ads API, wypełnij formularz wniosku o standardowy dostęp.
Jeśli narzędzie jest zewnętrzne, przygotuj się na to, że będziesz musiał(-a) udostępnić dostęp do wersji demonstracyjnej. Pamiętaj, że Twoje narzędzie musi być zgodne z wymaganiami dotyczącymi minimalnej funkcjonalności.
Dopuszczalne użytkowanie
Dozwolone użycie dotyczy tylko tokenów dostępu podstawowego i standardowego. Dozwolone użycie jest przydzielane na podstawie zamierzonego zastosowania interfejsu Google Ads API. Te uprawnienia określają, do których funkcji interfejsu API można używać tokena. Opisano je w tabeli poniżej:
Dopuszczalne użytkowanie | Opis |
---|---|
Tworzenie i zarządzanie reklamami | Dostęp do wszystkich usług interfejsu API na potrzeby tworzenia i zarządzania kampaniami, grupami reklam, reklamami i słowami kluczowymi Google Ads. |
Raportowanie | Możesz wysyłać tylko żądania GoogleAdsService.Search lub GoogleAdsService.SearchStream albo wykonywać tylko wywołania do odczytu. Ta opcja jest przeznaczona dla deweloperów, którzy korzystają z interfejsu API tylko do żądania statystyk.
|
Badanie słów kluczowych i rekomendacji | Zezwól tokenowi na dostęp do usług RecommendationService, KeywordPlanIdeaService i KeywordPlanService. Jest on używany tylko przez narzędzia wymagające sugestii, aby ułatwić tworzenie i zarządzanie kampaniami Google Ads. |
Zmiana dozwolonego użycia
Jeśli masz zatwierdzony dostęp podstawowy lub standardowy, możesz wypełnić formularz zgłoszeniowy, aby zaktualizować dozwolone użycie. Wypełnij wniosek, jeśli chcesz zaktualizować dozwolone użycie lub przyznać klientom dostęp do swojego narzędzia.