Do Twojego projektu w chmurze Google Cloud jest przypisany 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ć codziennie. 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 Test 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? |
|---|---|---|---|---|
| Test | Konta testowe | 15 000 operacji dziennie | Poproś o dostęp testowy | |
| Eksplorator | Konta testowe i produkcyjne | 2880 operacji dziennie na kontach produkcyjnych 15 000 operacji dziennie na kontach testowych |
Poproś o dostęp na poziomie eksploratora | |
| Podstawowe | Konta testowe i produkcyjne | 15 000 operacji dziennie na kontach testowych i produkcyjnych | Poproś o dostęp Basic | |
| Standardowy | Konta testowe i produkcyjne | Nieograniczona liczba operacji dziennie na kontach testowych i produkcyjnych | Poproś o dostęp standardowy | 10 dni roboczych |
1 „Dziennie” oznacza 24-godzinny okres, w którym wysyłano żądania do interfejsu API z Twojego projektu Google Cloud. Jeśli w ciągu ostatnich 24 godzin aplikacja przekroczy limit żądań dla Twojego poziomu dostępu, otrzymasz komunikat o błędzie.
Testowanie dostępu
Po włączeniu interfejsu Google Ads API Twój projekt w chmurze Google otrzymuje 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 testowy
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 Google może umożliwić Ci ubieganie się o poziom dostępu eksploratora.
Poziom dostępu eksploratora 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 konta, które wyświetlają prawdziwe 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. Większości deweloperów wystarczy to, aby rozpocząć korzystanie z interfejsu API i tworzyć podstawowe automatyzacje.
Poziom dostępu eksploratora ogranicza dostęp do tych funkcji. Jeśli chcesz korzystać z tych funkcji, musisz poprosić o dostęp podstawowy lub standardowy.
| Ograniczona funkcjonalność | Ograniczone usługi i metody |
|---|---|
| Tworzenie konta | CustomerService.CreateCustomerClient |
| Zarządzanie użytkownikami | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| Planowanie | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Płatności i rozliczenia na koncie | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Poproś o poziom dostępu eksploratora
- W projekcie Google Cloud otwórz stronę Przegląd interfejsu Google Ads API.
- 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 Eksplorator.
- 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 eksploratora.
Poziom dostępu podstawowy
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 konta, które wyświetlają prawdziwe reklamy Google. Konta testowe nie wyświetlają reklam.
Poziom dostępu podstawowy umożliwia projektowi Google Cloud wykonywanie do 15 000 operacji dziennie. Większości deweloperów wystarczy to.
Poproś o poziom dostępu podstawowy
.- W projekcie Google Cloud otwórz stronę Przegląd interfejsu Google Ads API.
- 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 nie masz zweryfikowanej marki w projekcie. Jeśli takie ostrzeżenia się pojawią, postępuj zgodnie z instrukcjami aby zweryfikować markę, zanim przejdziesz dalej.
- Aby poprosić o poziom dostępu podstawowy, 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 podstawowego.
Poziom dostępu standardowy
Poziom dostępu standardowy umożliwia projektowi w chmurze Google Cloud wykonywanie nieograniczonej liczby operacji dziennie we wszystkich usługach. Poszczególne usługi i funkcje mogą nadal mieć ograniczanie 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ł poziom dostępu standardowy .
Poziom dostępu standardowy jest przyznawany tylko deweloperom, którzy potrzebują nieograniczonej liczby operacji w interfejsie Google Ads API, np. dużym firmom lub narzędziom obsługującym wielu użytkowników.
Poproś o poziom dostępu standardowy
- W projekcie Google Cloud otwórz stronę Przegląd interfejsu Google Ads API.
- 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 Standardowy.
- Aby rozpocząć składanie wniosku o poziom dostępu standardowy, kliknij przycisk Rozpocznij składanie wniosku.
Wniosek o dostęp standardowy wymaga szczegółowego ręcznego sprawdzenia aplikacji. Przygotuj się na odpowiedzi 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 im dostępu po zalogowaniu 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ć rozpatrzenie wniosku o dostęp standardowy, odpowiadaj na pytania zespołu ds. zgodności. Po zakończeniu sprawdzania Google wyśle Ci e-maila z ostatecznym wynikiem.
Limity przydziału interfejsu API i ograniczanie liczby żądań w systemie
Niezależnie od poziomu dostępu wszystkie operacje interfejsu API podlegają limitom liczby żądań w systemie, 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 ograniczaniem liczby żądań, znajdziesz w artykule Typy błędów.
Poszczególne usługi mogą nakładać dodatkowe limity i ograniczenia przydziału z takich powodów jak ograniczenia projektowe, ograniczenia wynikające z zasad, wydajność interfejsu API i opóźnienia. Więcej informacji o tych ograniczeniach znajdziesz w dokumentacji dotyczącej limitów przydziału API.
Dopuszczalne użytkowanie
Dopuszczalne użytkowanie dotyczy tylko projektów Google Cloud z poziomem dostępu standardowym. 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. Szczegółowe informacje znajdziesz w tabeli poniżej:
| Dopuszczalne użytkowanie | Opis |
|---|---|
| Tworzenie i zarządzanie reklamami | Umożliwia dostęp do wszystkich usług interfejsu API w celu tworzenia kampanii Google Ads, grup reklam, reklam i słów kluczowych 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. |
| Badanie 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, które wymagają sugestii ułatwiających tworzenie kampanii Google Ads i zarządzanie nimi. |
Zmienianie dopuszczalnego użytkowania
Jeśli Twój projekt Google Cloud został zatwierdzony do poziomu 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.