Aby omawiać nasze usługi i przekazywać opinie na ich temat, dołącz do oficjalnego kanału Google Ads na Discordzie na serwerze społeczności Google Advertising and Measurement.

Ta strona została przetłumaczona przez Cloud Translation API.

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 programisty.

Poziomy dostępu

W tabeli wymienione są 4 poziomy dostępu do tokena dewelopera. Jeśli nie masz jeszcze dostępu do interfejsu Google Ads API, zacznij od zarejestrowania się, aby uzyskać token programisty z poziomem dostępu do konta testowego. Poziom dostępu możesz zwiększyć, wykonując w aplikacji dodatkowe czynności.

Poziom dostępu	Ma dostęp do…	Limit dzienny operacji¹	Jak przesłać zgłoszenie	Ile czasu 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 tys. operacji dziennie na kontach testowych i produkcyjnych	Instrukcje	2 dni robocze
Dostęp standardowy	Konta testowe i produkcyjne	Nieograniczona liczba operacji dziennie na kontach testowych i produkcyjnych	Instrukcje	10 dni roboczych

¹ „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 Twoja 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ć do interfejsu Google Ads API tylko żądania dotyczące kont testowych.

Jak przesłać prośbę o poziom dostępu do konta testowego

Aby automatycznie uzyskać dostęp do konta testowego, zarejestruj się w interfejsie Google Ads API w interfejsie internetowym Google Ads.

Poziom dostępu do eksploratora

Po wstępnej rejestracji w interfejsie Google Ads API możemy w niektórych przypadkach automatycznie podnieść poziom dostępu Twojego tokena programisty z dostępu do konta testowego do poziomu dostępu eksploracyjnego. Poziom dostępu Eksplorator umożliwia tokenowi programisty wysyłanie żądań do interfejsu Google Ads API w przypadku kont testowych 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 Eksplorator umożliwia tokenowi programisty wykonywanie do 2880 operacji dziennie na kontach produkcyjnych. Wystarczy to, aby większość programistów mogła rozpocząć korzystanie z interfejsu API i tworzyć podstawowe automatyzacje.

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

Ograniczona funkcjonalność	Usługi i metody objęte ograniczeniami
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 Eksplorator

Dokończ rejestrację w interfejsie Google Ads API w interfejsie internetowym Google Ads. W niektórych przypadkach po zakończeniu rejestracji Google może automatycznie uaktualnić Twój token dewelopera do poziomu dostępu Explorer.

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, 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 przesłać prośbę o poziom dostępu Podstawowy

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

Upewnij się, że masz już token programisty z poziomem dostępu do konta testowego.
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 Google Ads. Nie możesz ukończyć procesu rejestracji bez prawidłowego, regularnie sprawdzanego adresu e-mail. Upewnij się, że wszystkie aktywne konta Google Ads są połączone z kontem menedżera Google Ads 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 poziomu dostępu standardowego znajdziesz w sekcji 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 i chcesz poprosić o nieograniczoną liczbę operacji w interfejsie Google Ads API, wypełnij formularz wniosku o poziom dostępu standardowy.

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 zasadami dotyczącymi wymaganej minimalnej funkcjonalności.

Limity przydziału interfejsu API i limity częstotliwości żądań systemu

Niezależnie od poziomu dostępu wszystkie operacje interfejsu API podlegają limitom częstotliwości systemu, 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 żądań, znajdziesz w sekcji Rodzaje błędów.

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

Dopuszczalne użytkowanie

Dozwolone użycie dotyczy tylko tokenów deweloperskich z poziomami dostępu Podstawowy i Standardowy. 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 dewelopera, co zostało 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 programisty na dostęp do `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 zaktualizowanie dopuszczalnego użytku. Wypełnij wniosek, jeśli chcesz zaktualizować dopuszczalne zastosowanie lub przyznać klientom dostęp do narzędzia.