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 konkretne funkcje interfejsu Google Ads API, z których może korzystać token programisty.
Poziomy dostępu
W tabeli wymienione są 4 poziomy dostępu do tokena programisty. Jeśli nie masz jeszcze dostępu do interfejsu Google Ads API, zacznij od zarejestrowania się, aby uzyskać token programisty z poziomem dostępu do konta testowego. Poziom dostępu możesz zwiększyć, wykonując w aplikacji dodatkowe czynności.
| Poziom dostępu | Ma dostęp do… | Limit dzienny1 | Jak przesłać zgłoszenie | Ile czasu zwykle trwa sprawdzanie? |
|---|---|---|---|---|
| Poziom dostępu do konta testowego | Konta testowe | 15 000 operacji dziennie | Instrukcje | |
| Poziom dostępu Eksplorator | Konta testowe i produkcyjne | 2880 operacji dziennie na kontach produkcyjnych 15 000 operacji dziennie na kontach testowych |
Instrukcje | |
| Poziom dostępu podstawowego | Konta testowe i produkcyjne | 15 000 operacji dziennie na kontach testowych i produkcyjnych | Instrukcje | 5 dni roboczych |
| Dostęp standardowy | Konta testowe i produkcyjne | Nieograniczona liczba operacji dziennie na kontach testowych i produkcyjnych | Instrukcje | 10 dni roboczych |
1 „Dziennie” oznacza 24-godzinny okres, w którym za pomocą Twojego tokena programisty wysłano żądania do interfejsu API. Jeśli w ciągu ostatnich 24 godzin aplikacja przekroczy limit żądań dla Twojego poziomu dostępu, otrzyma błąd.
Poziom dostępu do konta testowego
Po wstępnej rejestracji w interfejsie Google Ads API otrzymasz token programisty z poziomem dostępu do konta testowego. Oznacza to, że token programisty może wysyłać do interfejsu Google Ads API tylko żądania dotyczące kont testowych.
Jak ubiegać się o poziom dostępu do konta testowego
Aby automatycznie uzyskać poziom dostępu do konta testowego, zarejestruj się w interfejsie Google Ads API w interfejsie internetowym Google Ads.
Poziom dostępu Eksplorator
Po zakończeniu wstępnej rejestracji w interfejsie Google Ads API możemy w niektórych przypadkach automatycznie podnieść poziom dostępu Twojego tokenu programisty z dostępu do konta testowego do poziomu dostępu eksploracyjnego. Poziom dostępu Eksplorator umożliwia tokenowi programisty wysyłanie żądań do interfejsu Google Ads API w przypadku kont testowych i produkcyjnych. Konta produkcyjne to konta, na których wyświetlają się prawdziwe reklamy Google. Na kontach testowych reklamy się nie wyświetlają.
Poziom dostępu Eksplorator umożliwia tokenowi programisty wykonywanie do 2880 operacji dziennie na kontach produkcyjnych. Wystarczy to, aby większość programistów mogła rozpocząć korzystanie z interfejsu API i tworzyć podstawowe automatyzacje.
Poziom dostępu Eksplorator ogranicza dostęp do tych funkcji: Jeśli chcesz korzystać z tych funkcji, musisz poprosić o podstawowy lub standardowy poziom dostępu.
| Ograniczona funkcjonalność | Usługi i metody objęte ograniczeniami |
|---|---|
| Tworzenie konta | CustomerService.CreateCustomerClient |
| Zarządzanie użytkownikami | CustomerUserAccessInvitationServiceCustomerUserAccessService
|
| Planowanie |
KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| Rozliczenia i płatności na koncie |
PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Jak ubiegać się o poziom dostępu Eksplorator
Zarejestruj się w interfejsie Google Ads API w interfejsie internetowym Google Ads. W niektórych przypadkach po zakończeniu rejestracji Google może automatycznie uaktualnić Twój token programisty do poziomu dostępu Explorer.
Poziom dostępu podstawowego
Poziom dostępu podstawowy umożliwia tokenowi programisty wysyłanie żądań do interfejsu Google Ads API w przypadku kont testowych i produkcyjnych. Konta produkcyjne to wszystkie konta, na których wyświetlają się prawdziwe reklamy Google – na kontach testowych reklamy się nie wyświetlają.
Poziom dostępu podstawowego umożliwia tokenowi programisty wykonywanie do 15 tys. operacji dziennie. Jest to wystarczające dla większości deweloperów.
Jak przesłać prośbę o poziom dostępu Podstawowy
Jeśli masz token dewelopera z poziomem dostępu Konto testowe lub Dostęp dla eksploratorów, możesz poprosić o poziom dostępu Podstawowy w ten sposób:
W przeglądarce otwórz https://ads.google.com/aw/apicenter. W razie potrzeby zaloguj się na konto menedżera Google Ads.
Sprawdź, czy poziom dostępu to Konto testowe lub Odkrywca.
Sprawdź, czy adres e-mail kontaktu w sprawie interfejsu API w centrum interfejsów API jest aktualny. Bez prawidłowego, regularnie sprawdzanego adresu e-mail nie będzie można ukończyć procesu składania wniosku. Upewnij się, że wszystkie aktywne konta Google Ads są połączone z kontem menedżera Google Ads z tokenem interfejsu API.
Kliknij strzałkę w dół obok opcji Poziom dostępu i kliknij link Złóż wniosek o podstawowy dostęp.
Przeprowadzanie weryfikacji marki w przypadku projektów Google Cloud
Podczas sprawdzania wniosków o poziom dostępu podstawowego interfejs Google Ads API korzysta ze stanu weryfikacji marki projektów Google Cloud powiązanych z tokenem programisty. Aby przyspieszyć proces weryfikacji wniosku o dostęp podstawowy, możesz przejść proces weryfikacji marki w projekcie w chmurze Google. W niektórych przypadkach możemy też poprosić Cię o przeprowadzenie weryfikacji marki w projektach Google Cloud jako warunek wstępny rozpatrzenia Twojej prośby o przyznanie podstawowego dostępu. Więcej informacji znajdziesz w przewodniku po weryfikacji marki.
Dostęp standardowy
Poziom dostępu standardowego umożliwia tokenowi programisty wykonywanie nieograniczonej liczby operacji dziennie w przypadku większości usług. Obejmuje to m.in.GoogleAdsService Search i SearchStream. Więcej informacji o limitach i wyjątkach dotyczących poziomu dostępu standardowego znajdziesz w sekcji Limity interfejsu API.
Poziom dostępu standardowego jest przyznawany tylko deweloperom, którzy potrzebują nieograniczonej liczby operacji interfejsu Google Ads API, np. dużym firmom lub narzędziom obsługującym wielu użytkowników.
Jak ubiegać się o poziom dostępu Standard
Jeśli masz token programisty z poziomem dostępu podstawowego, możesz poprosić o dostęp standardowy w ten sposób:
W przeglądarce otwórz https://ads.google.com/aw/apicenter. W razie potrzeby zaloguj się na konto menedżera Google Ads.
Sprawdź, czy poziom dostępu to Podstawowy.
Sprawdź, czy adres e-mail kontaktu w sprawie interfejsu API w centrum interfejsów API jest aktualny. Bez prawidłowego, regularnie sprawdzanego adresu e-mail nie będzie można ukończyć procesu składania wniosku. Upewnij się, że wszystkie aktywne konta Google Ads są połączone z kontem menedżera Google Ads z tokenem interfejsu API.
Kliknij strzałkę w dół obok pozycji Poziom dostępu i kliknij link Złóż wniosek o standardowy dostęp.
Jeśli z Twojego narzędzia korzystają użytkownicy zewnętrzni, przygotuj się na udostępnienie im dostępu do wersji demonstracyjnej. Pamiętaj, że Twoje narzędzie musi być zgodne z zasadami dotyczącymi wymaganej minimalnej funkcjonalności.
Limity przydziału interfejsu API i limity częstotliwości żądań systemu
Niezależnie od poziomu dostępu wszystkie operacje interfejsu API podlegają limitom częstotliwości systemowej, które ograniczają liczbę operacji, jakie można wykonać w określonym czasie, czyli liczbę operacji na godzinę. Więcej informacji o tym, jak radzić sobie z błędami związanymi z limitami żądań, znajdziesz w sekcji Rodzaje błędów.
Poszczególne usługi mogą nakładać dodatkowe limity i ograniczenia dotyczące limitów z powodu ograniczeń związanych z konstrukcją produktu, ograniczeń wynikających z zasad dotyczących produktu oraz kwestii związanych z wydajnością i opóźnieniami interfejsu API. Więcej informacji o tych ograniczeniach znajdziesz w dokumentacji dotyczącej limitów interfejsu API.
Dopuszczalne użytkowanie
Dozwolone użycie dotyczy tylko tokenów programisty z poziomami dostępu Podstawowy i Standardowy. Dozwolone użycie jest przyznawane na podstawie zamierzonego sposobu korzystania z interfejsu Google Ads API. Te uprawnienia określają, do których funkcji interfejsu API można używać tokena programisty, co zostało szczegółowo opisane w tej tabeli:
| Dozwolony użytek | Opis |
|---|---|
| Tworzenie reklam i zarządzanie nimi | Zapewnia dostęp do wszystkich usług interfejsu API do tworzenia kampanii, grup reklam, reklam i słów kluczowych w Google Ads oraz zarządzania nimi. |
| Raportowanie | Wysyłaj tylko żądania GoogleAdsService.Search
lub GoogleAdsService.SearchStream
albo wywołania tylko do odczytu. Jest on przeznaczony dla deweloperów, którzy używają interfejsu API tylko do wysyłania żądań statystyk.
|
| Wyszukiwanie słów kluczowych i rekomendacji | Zezwól tokenowi programisty na dostęp do RecommendationService, KeywordPlanIdeaService i KeywordPlanService.
Jest on używany tylko przez narzędzia wymagające sugestii, aby ułatwić tworzenie kampanii Google Ads i zarządzanie nimi.
|
Jak zmienić dozwolone użycie
Jeśli Twój token programisty został zatwierdzony na poziomie dostępu podstawowego lub standardowego, możesz wypełnić wniosek o zaktualizowanie dopuszczalnego użytku. Wypełnij wniosek, jeśli chcesz zaktualizować dopuszczalne zastosowanie lub przyznać klientom dostęp do narzędzia.