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ć dziennie. Dozwolone użycie określa konkretne funkcje interfejsu Google Ads API, z których może korzystać token programisty.
Poziomy dostępu
W tabeli poniżej znajdziesz 4 różne poziomy dostępu tokena programisty. Jeśli nie masz jeszcze dostępu do interfejsu Google Ads API, możesz zacząć od zarejestrowania się, aby uzyskać token programisty z poziomem dostępu do konta testowego. Poziom dostępu możesz zwiększyć, wykonując dodatkowe czynności w aplikacji.
| Poziom dostępu | Dostęp do... | Limit operacji dziennie1 | Jak przesłać zgłoszenie | Ile zwykle trwa sprawdzanie? |
|---|---|---|---|---|
| Poziom dostępu do konta testowego | Konta testowe | 15 000 operacji dziennie | Instrukcje | |
| Poziom dostępu eksploratora | 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 |
| Poziom dostępu standardowego | 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 wysyłano żądania do interfejsu API za pomocą tokena programisty. Jeśli w ciągu ostatnich 24 godzin aplikacja przekroczy limit żądań dla Twojego poziomu dostępu, otrzymasz 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ć żądania do interfejsu Google Ads API tylko w przypadku kont testowych.
znajdziesz w przewodniku po kontach 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 Google Ads.
Poziom dostępu eksploratora
Po wstępnej rejestracji w interfejsie Google Ads API w niektórych przypadkach Google może automatycznie podnieść poziom dostępu tokena programisty z poziomu dostępu do konta testowego na poziom dostępu eksploratora. Poziom dostępu eksploratora umożliwia tokenowi programisty wysyłanie żądań do interfejsu Google Ads API zarówno w przypadku kont testowych, jak 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 eksploratora umożliwia tokenowi programisty wykonywanie do 2880 operacji dziennie na kontach produkcyjnych. Większości programistów wystarczy to, aby rozpocząć korzystanie z interfejsu API i tworzenie podstawowych automatyzacji.
Poziom dostępu eksploratora ogranicza dostęp do tych funkcji. Jeśli chcesz korzystać z tych funkcji, musisz poprosić o poziom dostępu podstawowego lub standardowego.
| Ograniczone funkcje | Ograniczone usługi i metody |
|---|---|
| Tworzenie konta | CustomerService.CreateCustomerClient |
| Zarządzanie użytkownikami | CustomerUserAccessInvitationServiceCustomerUserAccessService
|
| Planowanie |
KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| Płatności i rozliczenia na koncie |
PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Jak ubiegać się o poziom dostępu eksploratora
Aby uzyskać poziom dostępu eksploratora, zarejestruj się w interfejsie Google Ads API w interfejsie Google Ads. W niektórych przypadkach po zakończeniu rejestracji Google może automatycznie podnieść poziom dostępu tokena programisty na poziom dostępu eksploratora.
Poziom dostępu podstawowego
Poziom dostępu podstawowego umożliwia tokenowi programisty wysyłanie żądań do interfejsu Google Ads API zarówno w przypadku kont testowych, jak 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 podstawowego umożliwia tokenowi programisty wykonywanie do 15 000 operacji dziennie. Większości programistów wystarczy to.
Jak ubiegać się o poziom dostępu podstawowego
Jeśli masz token programisty z poziomem dostępu do konta testowego lub poziomem dostępu eksploratora, możesz poprosić o poziom dostępu podstawowego:
W przeglądarce otwórz Centrum interfejsu API. Jeśli pojawi się prośba, zaloguj się na konto menedżera Google Ads.
Sprawdź, czy Twój poziom dostępu to Konto testowe lub Eksplorator.
Upewnij się, że adres e-mail kontaktu w sprawie interfejsu API w Centrum interfejsu API jest aktualny. Bez prawidłowego, regularnie sprawdzanego adresu e-mail nie będzie można dokończyć procesu składania wniosku. Upewnij się, że wszystkie aktywne konta Google Ads są połączone z kontem menedżera Google Ads za pomocą tokena interfejsu API.
Obok poziomu dostępu kliknij strzałkę w dół, a potem kliknij link Zgłoś prośbę o dostęp podstawowy.
Zakończ weryfikację marki w projektach 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 sprawdzania wniosku o dostęp podstawowy, możesz przejść proces weryfikacji marki w projekcie w chmurze Google. W niektórych przypadkach Google może też poprosić Cię o przejście weryfikacji marki w projektach Google Cloud jako warunek wstępny rozpatrzenia wniosku o dostęp podstawowy. Więcej informacji znajdziesz w przewodniku po weryfikacji marki.
Poziom dostępu standardowego
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 artykule 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 standardowego
Jeśli masz token programisty z poziomem dostępu podstawowego, możesz poprosić o poziom dostępu standardowego:
W przeglądarce otwórz Centrum interfejsu API. Jeśli pojawi się prośba, zaloguj się na konto menedżera Google Ads.
Sprawdź, czy Twój poziom dostępu to Podstawowy.
Upewnij się, że adres e-mail kontaktu w sprawie interfejsu API w Centrum interfejsu API jest aktualny. Bez prawidłowego, regularnie sprawdzanego adresu e-mail nie będzie można dokończyć procesu składania wniosku. Upewnij się, że wszystkie aktywne konta Google Ads są połączone z kontem menedżera Google Ads za pomocą tokena interfejsu API.
Obok poziomu dostępu kliknij strzałkę w dół, a potem kliknij link Zgłoś prośbę o dostęp standardowy.
Jeśli Twoje narzędzie jest używane przez użytkowników zewnętrznych, przygotuj się na udostępnienie im dostępu do niego w wersji demonstracyjnej. Pamiętaj, że Twoje narzędzie musi być zgodne z wymaganą minimalną funkcjonalnością.
Limity interfejsu API i limity systemowe
Niezależnie od poziomu dostępu wszystkie operacje interfejsu API podlegają limitom systemowym, 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, znajdziesz w artykule Typy błędów.
Poszczególne usługi mogą nakładać dodatkowe limity i ograniczenia dotyczące limitów z powodu ograniczeń projektowych, ograniczeń zasad dotyczących produktów, wydajności interfejsu API i opóźnień. Więcej informacji o tych ograniczeniach znajdziesz w dokumentacji dotyczącej limitów interfejsu API.
Dozwolone użycie
Dozwolone użycie dotyczy tylko tokenów programisty z poziomem dostępu podstawowego i standardowego. Dozwolone użycie jest przydzielane 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. Szczegółowe informacje znajdziesz w tabeli poniżej:
| Dozwolone użycie | Opis |
|---|---|
| Tworzenie i zarządzanie reklamami | Umożliwia dostęp do wszystkich usług interfejsu API służących do tworzenia kampanii, grup reklam, reklam i słów kluczowych Google Ads oraz zarządzania nimi. |
| Raportowanie | Umożliwia tylko wysyłanie żądań GoogleAdsService.Search
lub GoogleAdsService.SearchStream
albo wywoływanie tylko do odczytu. Jest to przeznaczone dla deweloperów, którzy używają interfejsu API tylko do
wysyłania żądań o statystyki.
|
| Wyszukiwanie słów kluczowych i rekomendacji | Umożliwia tokenowi programisty dostęp do usług RecommendationService,
KeywordPlanIdeaService,
i KeywordPlanService.
Jest to używane tylko przez narzędzia wymagające sugestii, które ułatwiają 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 dozwolonego użycia. Wypełnij wniosek, jeśli chcesz zaktualizować dozwolone użycie lub przyznać klientom dostęp do swojego narzędzia.