Do Twojego projektu Google Cloud przypisany jest 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, z których projekt może korzystać.
Poziomy dostępu
W tabeli wymienione są 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ć poziom dostępu testowego w projekcie w chmurze Google. Poziom dostępu możesz zwiększyć, wykonując w aplikacji dodatkowe czynności.
| Poziom dostępu | Dostęp do… | Dzienny limit operacji1 | Jak przesłać zgłoszenie | Ile zwykle trwa sprawdzanie? |
|---|---|---|---|---|
| Test | Konta testowe | 15 000 operacji dziennie | Zgłaszanie prośby o dostęp do testów | |
| 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 wersji Explorer | |
| Podstawowe | Konta testowe i produkcyjne | 15 000 operacji dziennie w przypadku kont testowych i produkcyjnych | Zgłaszanie prośby o dostęp podstawowy | |
| Standardowy | Konta testowe i produkcyjne | Nieograniczona liczba operacji dziennie na kontach testowych i produkcyjnych | Zgłaszanie prośby o dostęp standardowy | 10 dni roboczych |
1 „Dziennie” oznacza 24-godzinny okres, w którym w Twoim projekcie w chmurze Google wysłano żądania interfejsu API. Jeśli w ciągu ostatnich 24 godzin aplikacja przekroczy limit żądań dla Twojego poziomu dostępu, otrzymasz 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.
Poproś o dostęp do testów
Włącz interfejs Google Ads API w projekcie Google Cloud, aby automatycznie uzyskać dostęp testowy do projektu.
Poziom dostępu eksploratora
Po wstępnej rejestracji w interfejsie Google Ads API możesz poprosić o przyznanie poziomu dostępu Explorer.
Poziom dostępu Eksplorator umożliwia projektowi Google Cloud wysyłanie żądań do interfejsu Google Ads API zarówno na kontach testowych, jak i produkcyjnych. Konta produkcyjne to wszystkie konta, które wyświetlają prawdziwe, aktywne reklamy Google. Konta testowe nie wyświetlają reklam.
Poziom dostępu eksploratora umożliwia wykonywanie w Twoim projekcie Google Cloud maksymalnie 2880 operacji dziennie na kontach produkcyjnych. Wystarczy to, aby większość deweloperó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 przesłać prośbę o przyznanie podstawowego poziomu dostępu lub dostępu standardowego.
| Ograniczona funkcjonalność | Usługi i metody objęte ograniczeniami |
|---|---|
| Tworzenie konta | CustomerService.CreateCustomerClient |
| Zarządzanie użytkownikami | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| Planowanie | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Konto, rozliczenia i płatności | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Zgłaszanie prośby o dostęp na poziomie eksploratora
- Otwórz stronę Przegląd interfejsu Google Ads API w projekcie Google Cloud.
- Sprawdź, czy na stronie wyświetla się Twój obecny poziom dostępu jako Test.
- Kliknij, aby rozwinąć sekcję Uaktualnij poziom dostępu.
- Sprawdź, czy Następny poziom dostępu to Przeglądający.
- Aby poprosić o dostęp na poziomie eksploratora, kliknij przycisk Poproś o dostęp.
Po przesłaniu zgłoszenia Google może automatycznie uaktualnić poziom dostępu do interfejsu API Twojego projektu do poziomu Explorer.
Poziom dostępu podstawowego
Poziom dostępu Podstawowy umożliwia projektowi Google Cloud wysyłanie żądań do interfejsu Google Ads API zarówno w przypadku kont testowych, jak 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 podstawowego umożliwia wykonywanie w projekcie Google Cloud maksymalnie 15 tys. operacji dziennie. Jest to wystarczające dla większości deweloperów.
Prośba o poziom dostępu Podstawowy
- Otwórz stronę Przegląd interfejsu Google Ads API w projekcie Google Cloud.
- Sprawdź, czy na stronie wyświetla się Twój obecny poziom dostępu jako Eksplorator.
- Kliknij, aby rozwinąć sekcję Uaktualnij poziom dostępu.
- Sprawdź, czy Następny poziom dostępu to Podstawowy.
- Sprawdź, czy nie ma ostrzeżeń wskazujących, że weryfikacja marki w projekcie nie została zakończona. Jeśli tak, postępuj zgodnie z instrukcjami, aby dokończyć weryfikację marki przed kontynuowaniem.
- Aby ubiegać się o dostęp podstawowy, kliknij przycisk Złóż wniosek o dostęp.
Po przesłaniu wniosku Google może automatycznie uaktualnić poziom dostępu do interfejsu API w Twoim projekcie do poziomu Podstawowy.
Dostęp standardowy
Standardowy poziom dostępu umożliwia wykonywanie nieograniczonej liczby operacji dziennie we wszystkich usługach w Twoim projekcie Google Cloud. Poszczególne usługi i funkcje mogą nadal mieć limity liczby żądań i ograniczenia, które są specyficzne dla tych funkcji. Będą one obowiązywać nawet wtedy, gdy Twój projekt będzie miał standardowy poziom dostępu.
Poziom dostępu Standardowy 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.
Prośba o dostęp standardowy
- Otwórz stronę Przegląd interfejsu Google Ads API w projekcie Google Cloud.
- Sprawdź, czy na stronie wyświetla się Twój obecny poziom dostępu jako Podstawowy.
- Kliknij, aby rozwinąć sekcję Uaktualnij poziom dostępu.
- Sprawdź, czy Następny poziom dostępu to Standard.
- Kliknij przycisk Rozpocznij składanie wniosku, aby rozpocząć składanie wniosku o poziom dostępu standardowy.
Prośba o dostęp standardowy wymaga szczegółowego ręcznego sprawdzenia aplikacji. Przygotuj się na pytania dotyczące funkcjonalności narzędzia i 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. Pamiętaj, że Twoje narzędzie musi być zgodne z zasadami dotyczącymi wymaganej minimalnej funkcjonalności.
Podczas procesu weryfikacji zespół ds. zgodności w Google będzie się z Tobą kontaktować za pomocą Twojego adresu e-mail. Aby przyspieszyć rozpatrywanie wniosku o dostęp standardowy, szybko odpowiadaj na zapytania zespołu ds. zgodności. Gdy zakończymy weryfikację, otrzymasz od nas e-maila z ostatecznym wynikiem tego procesu.
Limity przydziału interfejsu API i limity częstotliwości żądań systemu
Niezależnie od poziomu dostępu wszystkie operacje interfejsu API podlegają limitom szybkości systemu, które ograniczają liczbę operacji, jakie możesz wykonać w określonym czasie, czyli liczbę operacji na godzinę. Więcej informacji o tym, jak radzić sobie z błędami związanymi z limitem żądań, znajdziesz w sekcji Rodzaje błędów.
Poszczególne usługi mogą mieć dodatkowe limity i ograniczenia dotyczące limitów z powodów takich jak ograniczenia wynikające z projektu usługi, ograniczenia wynikające z zasad dotyczących usługi 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
Dopuszczalne użycie ma zastosowanie tylko do projektów Google Cloud z dostępem standardowym. Dozwolone użycie jest przyznawane 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. Szczegółowe informacje znajdziesz w tabeli poniżej:
| Dopuszczalne użytkowanie | 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 w Google Ads oraz zarządzania nimi; |
| Raportowanie | Wysyłaj tylko żądania GoogleAdsService.Search lub GoogleAdsService.SearchStream albo wywołania tylko do odczytu. Jest on przeznaczony dla deweloperów, którzy używają interfejsu API tylko do wysyłania próśb o statystyki. |
| Wyszukiwanie słów kluczowych i rekomendacji | Zezwól projektowi Google Cloud na dostęp do adresów 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. |
Zmiana dopuszczalnego użytku
Jeśli Twój projekt Google Cloud został zatwierdzony na standardowy poziom dostępu, możesz wypełnić wniosek o aktualizację dopuszczalnego użytkowania. Wypełnij wniosek, jeśli chcesz zaktualizować dopuszczalne zastosowanie lub przyznać klientom dostęp do narzędzia.