Poziomy dostępu i dozwolone użycie

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:

  1. Sprawdź, czy masz już token programisty z poziomem dostępu do konta testowego.
  2. 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.