Poziomy dostępu i dozwolone użycie

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 wymienione są 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 dziennie^1	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 do 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	2 dni robocze
Poziom dostępu standardowego	Konta testowe i produkcyjne	Nieograniczona liczba operacji dziennie na kontach testowych i produkcyjnych	Instrukcje	10 dni roboczych

¹ „Dziennie” oznacza okres 24 godzin, 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 zakończeniu 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.

Ważne: więcej informacji o tworzeniu konta testowego

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 internetowym Google Ads API w Google Ads.

Poziom dostępu do eksploratora

Po zakończeniu 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 do eksploratora. Poziom dostępu do 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 wszystkie konta, na których wyświetlają się prawdziwe reklamy Google. Na kontach testowych reklamy się nie wyświetlają.

Poziom dostępu do 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 do eksploratora ogranicza dostęp do tych funkcji. Jeśli chcesz korzystać z tych funkcji, musisz ubiegać się o poziom dostępu podstawowego lub standardowego.

Ograniczone działanie	Ograniczone usługi i metody
Tworzenie konta	CustomerService.CreateCustomerClient
Zarządzanie użytkownikami	CustomerUserAccessInvitationService CustomerUserAccessService
Planowanie	KeywordPlanService KeywordPlanIdeaService KeywordPlanCampaignService KeywordPlanCampaignKeywordService KeywordPlanAdGroupService KeywordPlanAdGroupKeywordService AudienceInsightsService KeywordPlanIdeaService ReachPlanService
Rozliczenia i płatności na koncie	PaymentsAccountService BillingSetupService AccountBudgetProposalService InvoiceService

Jak ubiegać się o poziom dostępu do eksploratora

Dokończ rejestrację w 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 do 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 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 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 do eksploratora, możesz ubiegać się o poziom dostępu podstawowego w ten sposób:

1. W przeglądarce otwórz stronę https://ads.google.com/aw/apicenter. Jeśli pojawi się prośba, zaloguj się na konto menedżera Google Ads.

   Otwórz Centrum interfejsu API

2. Sprawdź, czy Twój poziom dostępu to Konto testowe lub Eksplorator.

3. 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ędziesz mieć możliwości ukończenia procesu składania wniosku. Upewnij się, że wszystkie aktywne konta Google Ads zostały połączone z kontem menedżera Google Ads za pomocą tokena interfejsu API.

4. Kliknij strzałkę w dół obok poziomu dostępu i kliknij link Zgłoś prośbę o dostęp podstawowy.

Zakończ weryfikację marki w projektach Google Cloud

Uwaga: weryfikacja marki jest opcjonalna i służy tylko jako sygnał do szybszego określenia, czy kwalifikujesz się do podstawowego dostępu do interfejsu Ads API. Jeśli masz już zatwierdzony token programisty i nie ubiegasz się o poziom dostępu podstawowego, nie musisz przechodzić weryfikacji marki.

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 wykorzystania interfejsu API.

Poziom dostępu standardowego jest przyznawany tylko programistom, 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 ubiegać się o poziom dostępu standardowego w ten sposób:

1. W przeglądarce otwórz stronę https://ads.google.com/aw/apicenter. Jeśli pojawi się prośba, zaloguj się na konto menedżera Google Ads.

   Otwórz Centrum interfejsu API

2. Sprawdź, czy Twój poziom dostępu to Podstawowy.

3. 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ędziesz mieć możliwości ukończenia procesu składania wniosku. Upewnij się, że wszystkie aktywne konta Google Ads zostały połączone z kontem menedżera Google Ads za pomocą tokena interfejsu API.

4. Kliknij strzałkę w dół obok poziomu dostępu i 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 wersji demonstracyjnej. Pamiętaj, że Twoje narzędzie musi być zgodne z wymaganą minimalną funkcjonalnością.

Limity wykorzystania 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 danym okresie, 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 powodów takich jak ograniczenia projektowe, ograniczenia zasad, wydajność interfejsu API i opóźnienia. Więcej informacji o tych ograniczeniach znajdziesz w dokumentacji dotyczącej limitów wykorzystania interfejsu API 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, jak opisano w tej tabeli:

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 Google Ads, grup reklam, reklam i słów kluczowych oraz zarządzania nimi.
Raportowanie	Umożliwia tylko wysyłanie żądań GoogleAdsService.Search lub GoogleAdsService.SearchStream albo wywołań tylko do odczytu. Jest to przeznaczone dla programistó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 aktualizację dozwolonego użycia. Wypełnij wniosek, jeśli chcesz zaktualizować dozwolone użycie lub przyznać klientom dostęp do swojego narzędzia.