Poziomy dostępu i dozwolone użycie

Każdy token programisty interfejsu Google Ads API ma przypisany poziom dostępu i „dopuszczalne zastosowanie”. 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 dewelopera.

Poziomy dostępu

W tabeli wymienione są 3 poziomy dostępu w odpowiedniej kolejności. Jeśli nie masz jeszcze dostępu do interfejsu Google Ads API, zacznij od zarejestrowania się, aby uzyskać dostęp do konta testowego. Możesz zwiększyć poziom dostępu, wykonując dodatkowe czynności w aplikacji.

Poziom dostępu Może uzyskać dostęp do… Limit dzienny1 Zastosuj
Dostęp do konta testowego 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 dziennie Instrukcje

1 „Dziennie” oznacza 24-godzinny okres, w którym wysyłano żądania do interfejsu API za pomocą Twojego tokena dewelopera. Jeśli w ciągu ostatnich 24 godzin aplikacja przekroczy limit żądań dla Twojego poziomu dostępu, otrzymasz błąd.

Dostęp 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 złożyć wniosek o dostęp do konta testowego

Wypełnij formularz rejestracyjny interfejsu Google Ads API w interfejsie internetowym Google Ads, aby automatycznie uzyskać poziom dostępu Konto testowe.

Dostęp podstawowy

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, które wyświetlają prawdziwe reklamy Google – konta testowe nie wyświetlają reklam.

Poziom dostępu podstawowego umożliwia tokenowi dewelopera wykonywanie do 15 tys. operacji dziennie. Jest to wystarczające dla większości deweloperów.

Jak ubiegać się o podstawowy dostęp

Jeśli masz token dewelopera z poziomem dostępu do konta testowego i chcesz ubiegać się o dostęp do konta produkcyjnego, wypełnij formularz wniosku o dostęp podstawowy. Upewnij się, że wykonane zostały te czynności:

  1. Upewnij się, że masz już token programisty z poziomem dostępu do konta testowego.
  2. Sprawdź, czy adres e-mail kontaktu ds. interfejsu API w centrum interfejsu API jest aktualny. Aby zobaczyć Centrum interfejsu API, musisz zalogować się na konto menedżera. 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 za pomocą tokena interfejsu API.

Dostęp standardowy

Poziom dostępu standardowego 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 poziomu dostępu 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, które obsługują wielu użytkowników.

Niezależnie od poziomu dostępu wszystkie operacje interfejsu API podlegają limitom szybkości systemu. Więcej informacji o tym, jak radzić sobie z błędami związanymi z limitem żądań, znajdziesz w sekcji Typy błędów.

Jak złożyć wniosek o dostęp standardowy

Jeśli masz token programisty z poziomem dostępu podstawowego i chcesz poprosić o nieograniczoną liczbę operacji w interfejsie Google Ads API, wypełnij formularz zgłoszeniowy dotyczący dostępu standardowego.

Jeśli Twoje narzędzie jest zewnętrzne, przygotuj się na udostępnienie dostępu do wersji demonstracyjnej. Pamiętaj, że Twoje narzędzie musi być zgodne z wymaganą minimalną funkcjonalnością.

Dopuszczalne użytkowanie

Dozwolone użycie dotyczy tylko tokenów deweloperskich z poziomami dostępu podstawowego i standardowego. Dozwolone użycie jest przydzielane na podstawie zamierzonego wykorzystania interfejsu Google Ads API. Te uprawnienia określają, do których funkcji interfejsu API można używać tokena dewelopera, co zostało szczegółowo opisane w tabeli poniżej:

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 Google Ads oraz zarządzania nimi.
Raportowanie Wysyłaj tylko żądania GoogleAdsService.Search lub GoogleAdsService.SearchStream albo wywołania tylko do odczytu. Jest to przeznaczone dla deweloperów, którzy używają interfejsu API tylko do wysyłania żądań statystyk.
Wyszukiwanie 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 kampanii Google Ads i zarządzanie nimi.

Jak zmienić dozwolone użycie

Jeśli Twój token dewelopera został zatwierdzony na poziomie dostępu podstawowego lub standardowego, możesz wypełnić wniosek o aktualizację dopuszczalnego użytku. Jeśli chcesz zaktualizować dopuszczalne zastosowanie lub przyznać klientom dostęp do narzędzia, wypełnij wniosek.