Poziomy dostępu i dopuszczalne użycie

Do Twojego projektu w chmurze Google Cloud jest przypisany poziom dostępu i „dopuszczalne 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, których można używać w projekcie.

Najważniejsza kwestia: zaczynasz korzystać z interfejsu Google Ads API? Tokeny programisty zostały wycofane 9 września 2026 r., a poziomy dostępu do interfejsu API są teraz zarządzane na poziomie projektu w chmurze Google. Po włączeniu interfejsu Google Ads API (co daje dostęp testowy) możesz od razu poprosić na stronie Przegląd interfejsu Google Ads API w konsoli Google Cloud o dostęp Explorer (w większości przypadków automatyczne sprawdzanie i zatwierdzanie, do 2880 operacji dziennie na kontach produkcyjnych). Aby dowiedzieć się, jak skonfigurować całe rozwiązanie, zapoznaj się z krótkim przewodnikiem po nawiązywaniu pierwszego połączenia lub przewodnikiem po serwerze MCP Google Ads.

Otwórz Przegląd interfejsu Google Ads API w konsoli Cloud

Poziomy dostępu

W tabeli wymieniono 4 poziomy dostępu do interfejsu API. Jeśli nie masz jeszcze dostępu do interfejsu Google Ads API, możesz zacząć od włączenia interfejsu API, aby uzyskać dostęp testowy do projektu w chmurze Google Cloud, a następnie poprosić o dostęp na poziomie Explorer na stronie Przegląd interfejsu Google Ads API, aby uzyskać dostęp do kont produkcyjnych.

Poziom dostępu	Dostęp…	Dzienny limit operacji^1	Jak przesłać zgłoszenie	Jak długo zwykle trwa sprawdzanie?
Test	Konta testowe	15 000 operacji dziennie	Zgłaszanie prośby o dostęp do Testu
Eksplorator	Konta testowe i produkcyjne	2880 operacji dziennie w przypadku kont produkcyjnych 15 000 operacji dziennie w przypadku kont testowych	Zgłaszanie prośby o dostęp do programu Explorer
Podstawowe	Konta testowe i produkcyjne	15 000 operacji dziennie zarówno w przypadku kont testowych,jak i produkcyjnych.	Składanie wniosku o dostęp podstawowy
Standardowy	Konta testowe i produkcyjne	Nieograniczona liczba operacji dziennie zarówno w przypadku kont testowych, jak i produkcyjnych	Składanie wniosku o dostęp standardowy	10 dni roboczych

¹ „Dziennie” oznacza ruchomy 24-godzinny okres, w którym żądania do interfejsu API były wysyłane w Twoim projekcie w chmurze Google. Jeśli aplikacja przekroczy limit żądań dla Twojego poziomu dostępu w ciągu ostatnich 24 godzin, wystąpi błąd.

Testowanie dostępu

Po włączeniu interfejsu Google Ads API Twój projekt w chmurze Google otrzyma dostęp testowy. Oznacza to, że projekt 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.

Przesyłanie prośby o dostęp testowy

Włącz interfejs Google Ads API w projekcie Google Cloud, aby automatycznie uzyskać dostęp testowy do projektu.

Poziom dostępu Eksplorator

Po zakończeniu wstępnej rejestracji w interfejsie Google Ads API Google może Ci zezwolić na ubieganie się o poziom dostępu Odkrywca.

Poziom dostępu Eksplorator umożliwia projektowi Google Cloud wysyłanie żądań do interfejsu Google Ads API zarówno do kont testowych, jak i produkcyjnych. Konta produkcyjne to konta, które wyświetlają prawdziwe, aktywne reklamy Google. Konta testowe nie wyświetlają reklam.

Poziom dostępu eksploratora umożliwia projektowi w chmurze Google Cloud wykonywanie do 2880 operacji dziennie na kontach produkcyjnych. Wystarczy to większości deweloperów, aby rozpocząć korzystanie z interfejsu API i utworzyć podstawową automatyzację.

Poziom dostępu Eksplorujący ogranicza dostęp do tych funkcji. Jeśli chcesz korzystać z tych funkcji, musisz poprosić o podstawowy poziom dostępu lub dostęp standardowy.

Ograniczona funkcjonalność	Usługi i metody z ograniczeniami
Tworzenie konta	CustomerService.CreateCustomerClient
Zarządzanie użytkownikami	CustomerUserAccessInvitationService CustomerUserAccessService
Planowanie	KeywordPlanService KeywordPlanIdeaService KeywordPlanCampaignService KeywordPlanCampaignKeywordService KeywordPlanAdGroupService KeywordPlanAdGroupKeywordService AudienceInsightsService ReachPlanService
Rozliczenia i płatności na koncie	PaymentsAccountService BillingSetupService AccountBudgetProposalService InvoiceService

Składanie wniosku o dostęp na poziomie eksploratora

1. W projekcie Google Cloud otwórz stronę Przegląd interfejsu Google Ads API.
2. Sprawdź, czy na stronie wyświetla się Twój bieżący poziom dostępu jako Test.
3. Kliknij, aby rozwinąć sekcję Uaktualnij poziom dostępu.
4. Sprawdź, czy Następny poziom dostępu to Odkrywca.
5. Kliknij przycisk Poproś o dostęp, aby poprosić o dostęp na poziomie eksploratora.

Po przesłaniu zgłoszenia Google może automatycznie uaktualnić poziom dostępu do interfejsu API w Twoim projekcie do poziomu Explorer.

Podstawowy poziom dostępu

Poziom dostępu podstawowego umożliwia projektowi Google Cloud wysyłanie żądań do interfejsu Google Ads API zarówno do kont testowych, jak i produkcyjnych. Konta produkcyjne to konta, które wyświetlają prawdziwe, aktywne reklamy Google. Konta testowe nie wyświetlają reklam.

Poziom dostępu Podstawowy umożliwia wykonywanie w projekcie Google Cloud do 15 000 operacji dziennie. W przypadku większości deweloperów jest to wystarczające.

Przesyłanie prośby o podstawowy poziom dostępu

Uwaga: aby móc ubiegać się o podstawowy poziom dostępu, musisz najpierw przejść weryfikację marki w projekcie Google Cloud. Aby dowiedzieć się więcej, zapoznaj się z przewodnikiem po weryfikacji marki.

1. W projekcie Google Cloud otwórz stronę Przegląd interfejsu Google Ads API.
2. Sprawdź, czy na stronie wyświetla się Twój obecny poziom dostępu jako Eksplorator.
3. Kliknij, aby rozwinąć sekcję Uaktualnij poziom dostępu.
4. Sprawdź, czy Następny poziom dostępu jest wyświetlany jako Podstawowy.
5. Sprawdź, czy nie ma ostrzeżeń wskazujących, że nie ukończono weryfikacji marki w projekcie. Jeśli tak, postępuj zgodnie z instrukcjami, aby dokończyć weryfikację marki, zanim przejdziesz dalej.
6. Kliknij przycisk Poproś o dostęp, aby poprosić o podstawowy poziom dostępu.

Po przesłaniu zgłoszenia Google może automatycznie uaktualnić poziom dostępu do interfejsu API w Twoim projekcie do poziomu podstawowego.

Dostęp standardowy

Standardowy poziom dostępu umożliwia projektowi Google Cloud wykonywanie nieograniczonej liczby operacji dziennie we wszystkich usługach. Poszczególne usługi i funkcje mogą nadal podlegać ograniczeniom liczby żądań i innym ograniczeniom, które są specyficzne dla tych funkcji i będą nadal obowiązywać, nawet jeśli Twój projekt ma standardowy poziom dostępu.

Dostęp standardowy jest przyznawany tylko deweloperom, którzy potrzebują nieograniczonej liczby operacji w interfejsie Google Ads API, np. dużym firmom lub narzędziom, które obsługują wielu użytkowników.

Przesyłanie prośby o dostęp standardowy

1. W projekcie Google Cloud otwórz stronę Przegląd interfejsu Google Ads API.
2. Sprawdź, czy na stronie wyświetla się Twój obecny poziom dostępu jako Podstawowy.
3. Kliknij, aby rozwinąć sekcję Uaktualnij poziom dostępu.
4. Sprawdź, czy Następny poziom dostępu jest wyświetlany jako Standardowy.
5. Kliknij przycisk Rozpocznij składanie wniosku, aby rozpocząć proces ubiegania się o dostęp standardowy.

Prośba o dostęp standardowy wymaga szczegółowej ręcznej weryfikacji aplikacji. Przygotuj się na pytania dotyczące funkcji narzędzia i jego docelowych odbiorców. Jeśli z Twojego narzędzia korzystają użytkownicy zewnętrzni, przygotuj się na udostępnienie dostępu po zalogowaniu do wersji demonstracyjnej narzędzia. Pamiętaj, że narzędzie musi być zgodne z wymaganą minimalną funkcjonalnością.

Podczas procesu weryfikacji zespół Google ds. zgodności będzie się z Tobą kontaktować, używając Twojego adresu e-mail. Aby przyspieszyć rozpatrywanie wniosku o dostęp standardowy, szybko odpowiadaj na pytania zespołu ds. zgodności. Gdy zakończymy weryfikację, otrzymasz e-maila z ostatecznym wynikiem procesu sprawdzania.

Limity interfejsu API i ograniczanie liczby żądań systemu

Niezależnie od poziomu dostępu wszystkie operacje interfejsu API podlegają systemowym limitom liczby żądań, które ograniczają liczbę operacji, które możesz wykonać w danym okresie, czyli liczbę operacji na godzinę. Więcej informacji o tym, jak postępować w przypadku błędów związanych z ograniczaniem liczby żądań, znajdziesz w sekcji Typy błędów.

Poszczególne usługi mogą nakładać dodatkowe limity i ograniczenia z powodów takich jak ograniczenia związane z projektem usługi, ograniczenia wynikające z zasad usługi, wydajność interfejsu API i kwestie związane z opóźnieniami. Więcej informacji o tych ograniczeniach znajdziesz w dokumentacji dotyczącej limitów interfejsu API.

Dozwolony użytek

Dopuszczalne wykorzystanie dotyczy tylko projektów w chmurze Google Cloud z dostępem standardowym. Dozwolone użycie jest przydzielane na podstawie zamierzonego użycia interfejsu Google Ads API. Te uprawnienia określają, z których funkcji interfejsu API może korzystać Twoje narzędzie, jak opisano w tabeli poniżej:

Dozwolony użytek	Opis
Tworzenie reklam i zarządzanie nimi	Zapewnij dostęp do wszystkich usług interfejsu API, aby umożliwić tworzenie kampanii Google Ads, grup reklam, reklam i słów kluczowych oraz zarządzanie nimi.
Raportowanie	Wysyłaj tylko żądania GoogleAdsService.Search lub GoogleAdsService.SearchStream albo wywołania tylko do odczytu. Dotyczy to deweloperów, którzy używają interfejsu API tylko do wysyłania żądań statystyk.
Wyszukiwanie słów kluczowych i rekomendacji	Zezwól projektowi Google Cloud na dostęp do RecommendationService, KeywordPlanIdeaService i KeywordPlanService. Są one używane tylko przez narzędzia, które wymagają sugestii, aby ułatwić tworzenie kampanii Google Ads i zarządzanie nimi.

Zmiana dopuszczalnego wykorzystania

Jeśli Twój projekt w chmurze Google Cloud został zatwierdzony na poziomie dostępu Standard, możesz wypełnić wniosek o aktualizację dozwolonego zastosowania. Jeśli chcesz zaktualizować dopuszczalne zastosowanie lub przyznać klientom dostęp do narzędzia, wypełnij wniosek.