Poziomy dostępu i dopuszczalne użycie

Do Twojego projektu w chmurze Google przypisany jest poziom dostępu i „dopuszczalne użytkowanie”. Poziom dostępu określa, czy możesz wpływać na konta produkcyjne, oraz liczbę operacji i żądań, które możesz wykonywać dziennie. Dopuszczalne użytkowanie określa konkretne funkcje interfejsu Google Ads API, z których projekt może korzystać.

Poziomy dostępu

W tabeli wymienione są 4 różne 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ć poziom dostępu do konta testowego w projekcie Google Cloud. 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 Poproś o dostęp do konta testowego
Poziom dostępu eksploratora Konta testowe i produkcyjne 2880 operacji dziennie na kontach produkcyjnych
15 000 operacji dziennie na kontach testowych
Poproś o dostęp eksploratora
Poziom dostępu podstawowego Konta testowe i produkcyjne 15 000 operacji dziennie na kontach testowych i produkcyjnych Poproś o dostęp podstawowy
Poziom dostępu standardowego Konta testowe i produkcyjne Nieograniczona liczba operacji dziennie na kontach testowych i produkcyjnych Poproś o dostęp standardowy 10 dni roboczych

1 „Dziennie” oznacza ruchome 24-godzinne okno czasowe, w którym wysyłano żądania do interfejsu API z Twojego projektu w chmurze Google. 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 włączeniu interfejsu Google Ads API Twój projekt w chmurze Google otrzymuje poziom dostępu do konta testowego. Oznacza to, że projekt może wysyłać żądania do interfejsu Google Ads API tylko w przypadku kont testowych.

Poproś o poziom dostępu do konta testowego

Aby automatycznie uzyskać poziom dostępu do konta testowego w projekcie, włącz interfejs Google Ads API w projekcie Google Cloud.

Poziom dostępu eksploratora

Po wstępnej rejestracji w interfejsie Google Ads API Google może umożliwić Ci ubieganie się o poziom dostępu eksploratora.

Poziom dostępu eksploratora umożliwia Twojemu projektowi w chmurze Google 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 eksploratora umożliwia Twojemu projektowi w chmurze Google Cloud wykonywanie do 2880 operacji dziennie na kontach produkcyjnych. Większości deweloperów wystarczy to, aby rozpocząć korzystanie z interfejsu API i tworzenie podstawowych automatyzacji.

Poziom dostępu eksploratora ogranicza dostęp do tych funkcji. Jeśli chcesz korzystać z tych funkcji, musisz poprosić o poziom dostępu podstawowego lub standardowego.

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

Poproś o poziom dostępu 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 obecny poziom dostępu jako Testowy.
  3. Kliknij, aby rozwinąć sekcję Uaktualnij poziom dostępu.
  4. Sprawdź, czy Następny poziom dostępu jest wyświetlany jako Eksplorator.
  5. Aby poprosić o poziom dostępu eksploratora, kliknij przycisk Poproś o dostęp.

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

Poziom dostępu podstawowego

Poziom dostępu Basic umożliwia Twojemu projektowi w chmurze Google 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 Twojemu projektowi w chmurze Google Cloud wykonywanie do 15 000 operacji dziennie. Większości deweloperów wystarczy to.

Poproś o poziom dostępu podstawowego

.
  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 masz zweryfikowanej marki w projekcie. Jeśli takie ostrzeżenia się pojawią, przed kontynuowaniem wykonaj instrukcje, aby zweryfikować markę.
  6. Aby poprosić o poziom dostępu podstawowego, kliknij przycisk Poproś o dostęp.

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

Poziom dostępu standardowego

Poziom dostępu standardowego umożliwia Twojemu projektowi w chmurze Google Cloud wykonywanie nieograniczonej liczby operacji dziennie we wszystkich usługach. Poszczególne usługi i funkcje mogą nadal mieć limity i ograniczenia dotyczące tych funkcji, które będą obowiązywać nawet wtedy, gdy Twój projekt będzie miał poziom dostępu standardowego.

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.

Poproś o poziom dostępu standardowego

  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. Aby rozpocząć składanie wniosku o poziom dostępu standardowego, kliknij przycisk Rozpocznij składanie wniosku.

Wniosek o poziom dostępu standardowego wymaga szczegółowego ręcznego sprawdzenia Twojej aplikacji. Przygotuj się na pytania dotyczące funkcjonalności narzędzia i jego docelowych odbiorców. Jeśli Twoje narzędzie jest używane przez użytkowników zewnętrznych, przygotuj się na udostępnienie dostępu do narzędzia w wersji demonstracyjnej. Pamiętaj, że Twoje narzędzie musi być zgodne z wymaganą minimalną funkcjonalnością.

W trakcie procesu sprawdzania zespół ds. zgodności Google będzie się z Tobą kontaktować za pomocą Twojego adresu e-mail. Aby przyspieszyć rozpatrywanie wniosku o poziom dostępu standardowego, odpowiadaj na pytania zespołu ds. zgodności. Po zakończeniu sprawdzania Google wyśle Ci e-maila z ostatecznym wynikiem.

Limity 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 sekcji Typy błędów.

Poszczególne usługi mogą nakładać dodatkowe limity i ograniczenia dotyczące limitów z powodu ograniczeń projektowych, ograniczeń zasad dotyczących produktów, wydajności interfejsu API i opóźnień. Więcej informacji o tych ograniczeniach znajdziesz w dokumentacji dotyczącej limitów interfejsu API.

Dopuszczalne użytkowanie

Dopuszczalne użytkowanie dotyczy tylko projektów Google Cloud z poziomem dostępu standardowego. Dopuszczalne użytkowanie jest przydzielane na podstawie zamierzonego sposobu korzystania z 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:

Dopuszczalne użytkowanie Opis
Tworzenie i zarządzanie reklamami Umożliwia dostęp do wszystkich usług interfejsu API do tworzenia kampanii, grup reklam, reklam i słów kluczowych w Google Ads oraz zarządzania nimi.
Raportowanie Umożliwia tylko wysyłanie żądań GoogleAdsService.Search lub GoogleAdsService.SearchStream albo wywoływanie tylko do odczytu. Jest to przeznaczone dla deweloperów, którzy używają interfejsu API tylko do żądania statystyk.
Wyszukiwanie słów kluczowych i rekomendacji Umożliwia projektowi Google Cloud 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.

Zmienianie dopuszczalnego użytkowania

Jeśli Twój projekt Google Cloud został zatwierdzony na poziomie dostępu standardowego, możesz wypełnić wniosek o aktualizację dopuszczalnego użytkowania. Wypełnij wniosek, jeśli chcesz zaktualizować dopuszczalne użytkowanie lub przyznać klientom dostęp do swojego narzędzia.