Poziomy dostępu i dozwolone użycie

Każdy token programisty interfejsu API Google Ads ma przypisany poziom dostępu, a dozwolone użycie&quot. 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 przypadki użycia określają określone funkcje interfejsu Google Ads API, z których może korzystać token tokena.

Poziomy dostępu

W tabeli są wymienione trzy różne poziomy dostępu. Jeśli nie masz jeszcze dostępu do interfejsu Google Ads API, zacznij od zarejestrowania się, aby go uzyskać. Możesz zwiększyć poziom dostępu, wykonując dodatkowe instrukcje dotyczące aplikacji.

Poziom dostępu Ma dostęp... Dzienny limit operacji1 Dzienny limit liczby operacji get2 Zastosuj
Sprawdź dostęp do konta Konta testowe 15 000 operacji / dzień 1000 żądań dziennie Instrukcje
Dostęp podstawowy Konta testowe i produkcyjne 15 000 operacji / dzień 1000 żądań dziennie Instrukcje
Dostęp standardowy Konta testowe i produkcyjne Nieograniczona liczba operacji dziennie 1000 żądań dziennie Instrukcje

1 „dziennie” bazuje na stałym okresie 24 godzin, w którym żądania interfejsu API były wysyłane za pomocą tokena programisty. Jeśli w ciągu ostatnich 24 godzin liczba żądań dla Twojego poziomu dostępu przekroczyła limit aplikacji, pojawi się błąd.

2 Wersja get jest wycofywana w wersji 10. Aby pobrać obiekty, użyj search lub searchStream.

Sprawdź dostęp do konta

Gdy zarejestrujesz się w Google Ads API, otrzymasz token programisty z poziomem dostępu do konta testowego. Oznacza to, że token programisty może wysyłać żądania interfejsu Google Ads API tylko do kont testowych.

Składanie wniosku o dostęp do konta testowego

Wystarczy, że wypełnisz rejestrację w interfejsie Google Ads API w interfejsie Google Ads, a Twój dostęp do konta testowego zostanie automatycznie przyznany.

Dostęp podstawowy

Podstawowy dostęp umożliwia tokenowi programisty wysyłanie żądań do interfejsu Google Ads API z kont testowych i produkcyjnych. Konta produkcyjne to wszystkie konta, na których wyświetlają się rzeczywiste reklamy Google (na kontach testowych nie wyświetlają się reklamy).

Podstawowy poziom dostępu umożliwia tokenowi programisty wykonywanie maksymalnie 15 000 żądań dziennie i 1000 operacji get dziennie. W większości przypadków to wystarczy.

Składanie wniosku o dostęp podstawowy

Jeśli masz token dewelopera poziomu dostępu do konta testowego i chcesz poprosić o dostęp do konta produkcyjnego, wypełnij podstawowy formularz zgłoszeniowy. Wykonaj te proste czynności:

  1. Sprawdź, czy masz już token dewelopera z poziomem dostępu do konta testowego.
  2. Sprawdź, czy Adres e-mail osoby kontaktowej ds. interfejsów API w Centrum API jest aktualny. Bez poprawnego, regularnie sprawdzanego kontaktowego adresu e-mail dewelopera nie można przejść procesu zgłoszenia. Upewnij się, że wszystkie aktywne konta Google Ads zostały połączone z kontem menedżera za pomocą tokena API.

Dostęp standardowy

Dostęp standardowy umożliwia tokenowi programisty wykonywanie nieograniczonej liczby operacji dziennie w większości usług. Zabronione jest m.in. GoogleAdsService Search oraz SearchStream. Szczegółowe informacje na temat limitów i wyjątków znajdziesz na stronie Limity interfejsu API.

Standardowe tokeny dostępu nadal podlegają dziennemu limitowi 1000 operacji get. Standardowy poziom dostępu otrzymają tylko deweloperzy, którzy wymagają nieograniczonej liczby operacji Google Ads API (zwykle dużych firm lub narzędzi, które obsługują wielu użytkowników).

Składanie wniosku o dostęp standardowy

Jeśli masz podstawowy poziom dostępu i chcesz poprosić o nieograniczoną liczbę operacji interfejsu Google Ads API, wypełnij standardowy formularz dostępu.

Jeśli używasz narzędzia zewnętrznego, przygotuj dostęp do niego demonstracją logowania. Pamiętaj, że Twoje narzędzie musi być zgodne z Wymaganymi minimalnymi funkcjami.

Dozwolone użycie

Dozwolone przypadki użycia obejmują tylko tokeny dostępu podstawowego i standardowego. Dozwolone użycie jest przydzielane na podstawie zamierzonego wykorzystania interfejsu Google Ads API. Te uprawnienia określają, do jakich funkcji interfejsu API można używać tokena, jak pokazano w poniższej tabeli.

Poniżej znajdziesz listę dozwolonych zastosowań:

Dozwolone użycie Opis
Tworzenie reklam i zarządzanie nimi Zapewnia dostęp do wszystkich usług interfejsu API umożliwiających tworzenie kampanii, grup reklam, reklam i słów kluczowych w Google Ads oraz zarządzanie nimi.
Raportowanie Wysyłaj żądania GoogleAdsService.Search lub GoogleAdsService.SearchStream (lub połączenia tylko do odczytu). Jest przeznaczona dla deweloperów, którzy używają interfejsu API tylko do przesyłania żądań o statystyki.
Badanie słów kluczowych i rekomendacji Zezwól tokenowi na dostęp do usługi RecommendationService, KeywordPlanIdeaService i KeywordPlanService. Narzędzie jest używane tylko w przypadku narzędzi, które wymagają sugestii ułatwiających tworzenie kampanii Google Ads i zarządzanie nimi.

Zmiana dozwolonych zastosowań

Jeśli masz przyznany dostęp podstawowy lub standardowy, możesz wypełnić wniosek o aktualizację dopuszczalnego użytkowania. Wypełnij wniosek, jeśli chcesz zaktualizować dozwolone użycie lub przyznaj klientom dostęp do tego narzędzia.