Poziomy dostępu i dozwolone użycie

Każdy token programisty interfejsu Google Ads API ma przypisany poziom dostępu i „dopuszczalne użycie”. Poziom dostępu określa, czy możesz mieć wpływ na konta produkcyjne oraz na 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ą 3 poziomy dostępu uporządkowane. Jeśli nie masz jeszcze dostępu do interfejsu Google Ads API, możesz go zacząć od zarejestrowania się, aby uzyskać dostęp do konta testowego. Możesz zwiększyć poziom dostępu, wykonując kilka dodatkowych czynności w aplikacji.

Poziom dostępu Ma dostęp... Dzienny limit operacji1 Skorzystaj
Testowanie dostępu do konta Konta testowe 15 000 operacji / dzień Instrukcje
Dostęp podstawowy Konta testowe i produkcyjne 15 000 operacji / dzień Instrukcje
Dostęp standardowy Konta testowe i produkcyjne Nieograniczona liczba operacji / dzień Instrukcje

1 Wartość „dziennie” odnosi się do 24-godzinnego okresu, w którym żądania do interfejsu API były wysyłane za pomocą Twojego tokena programisty. Aplikacja wyświetli błąd, jeśli w ciągu ostatnich 24 godzin przekroczy limit żądań określony dla Twojego poziomu dostępu.

Testowanie dostępu do konta

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ć żądania do interfejsu Google Ads API tylko wobec kont testowych.

Składanie wniosku o dostęp do konta testowego

Dokończ rejestrację w interfejsie Google Ads API w interfejsie internetowym Google Ads, aby automatycznie uzyskać poziom dostępu do konta testowego.

Dostęp podstawowy

Dostęp podstawowy umożliwia token programisty wysyłanie żądań do interfejsu Google Ads API zarówno do kont testowych, jak i produkcyjnych. Konta produkcyjne to wszystkie konta, które wyświetlają prawdziwe, aktywne reklamy Google – konta testowe nie wyświetlają reklam.

Podstawowy poziom dostępu pozwala wykonać token programisty do 15 000 operacji dziennie. W przypadku większości deweloperów to wystarcza.

Zgłaszanie prośby o dostęp podstawowy

Jeśli masz obecnie token programisty na poziomie konta testowego i chcesz poprosić o dostęp do konta w wersji produkcyjnej, wypełnij formularz zgłoszeniowy dotyczący dostępu podstawowego. Upewnij się, że wykonane zostały te czynności:

  1. Sprawdź, czy masz już token programisty z poziomem dostępu do konta testowego.
  2. Upewnij się, że kontaktowy adres e-mail interfejsu API w centrum interfejsu API jest aktualny. Bez prawidłowego, regularnie sprawdzanego adresu e-mail nie możesz ukończyć procesu zgłaszania. Sprawdź, czy wszystkie Twoje aktywne konta Google Ads zostały połączone z kontem menedżera za pomocą tokena API.

Dostęp standardowy

Dostęp standardowy umożliwia token programisty wykonywanie w przypadku większości usług nieograniczonej liczby operacji dziennie. Obejmuje to między innymi GoogleAdsService Search i SearchStream. Więcej informacji o limitach i wyjątkach dostępu standardowego znajdziesz w artykule o limitach interfejsu API.

Standardowy poziom dostępu jest przyznawany tylko deweloperom, którzy wymagają nieograniczonych działań związanych z interfejsem Google Ads API, na przykład dużym firmom lub narzędziom obsługującym wielu użytkowników.

Niezależnie od poziomu dostępu wszystkie operacje interfejsu API podlegają ograniczeniom dotyczącym szybkości systemu. Więcej informacji o naprawianiu błędów limitu liczby żądań znajdziesz w artykule Typy błędów.

Zgłaszanie prośby o dostęp standardowy

Jeśli masz obecnie podstawowy poziom dostępu i chcesz zgłosić się do nieograniczonej liczby operacji w interfejsie Google Ads API, wypełnij formularz zgłoszenia standardowego.

Jeśli Twoje narzędzie jest zewnętrzne, przygotuj do niego dostęp w trybie demonstracyjnym. Pamiętaj, że Twoje narzędzie musi być zgodne z wymaganą minimalną wydajnością.

Dozwolone użycie

Dozwolone przypadki użycia dotyczą tylko podstawowych i standardowych tokenów dostępu. Dozwolone użycie jest przydzielane na podstawie planowanego użycia interfejsu Google Ads API. Te uprawnienia określają, do których funkcji interfejsu API można wykorzystać token. Więcej informacji znajdziesz w tej tabeli:

Dozwolone użycie Opis
Tworzenie reklamy lub zarządzanie nią Zapewnia dostęp do wszystkich usług interfejsu API w zakresie 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. Przeznaczone dla programistów, którzy używają interfejsu API tylko do przesyłania żądań statystyk.
Szukanie słów kluczowych i rekomendacji Zezwól tokenowi na dostęp do usług RecommendationService, KeywordPlanIdeaService i KeywordPlanService. Jest używany tylko w przypadku narzędzi wymagających sugestii, aby ułatwić tworzenie kampanii Google Ads i zarządzanie nimi.

Zmienianie dozwolonego użycia

Jeśli masz dostęp podstawowy lub standardowy, możesz wypełnić aplikację do zaktualizowania dozwolonego użycia. Jeśli chcesz zaktualizować dozwolone użycie lub przyznać klientom dostęp do narzędzia, wypełnij formularz.