Biblioteki klienckie

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Nasze biblioteki klientów zapewniają widoki ogólne i podstawowe funkcje interfejsu Google Ads API, co ułatwia tworzenie aplikacji. Jeśli nie masz doświadczenia z interfejsem API, zalecamy zacząć od niego.

Biblioteka klienta Źródło Dystrybucja Przykłady kodu
Java google-ads-java Maven, tar.gz Wyświetl na GitHubie
.NET google-ads-dotnet tar.gz, zip Wyświetl na GitHubie
PHP google-ads-php tar.gz Wyświetl na GitHubie
Python google-ads-python tar.gz, zip Wyświetl na GitHubie
Ruby google-ads-ruby gem, tar.gz, zip Wyświetl na GitHubie
Perl google-ads-perl tar.gz, zip Wyświetl na GitHubie

Obsługiwane wersje interfejsu API

W tabeli poniżej znajdziesz konkretne wersje biblioteki, które obsługują każdą dostępną wersję interfejsu API.

Java

API i obsługiwane wersje Min/Max
wersja 12 Min: 22.0.0
Max: -
wersja 11 Min: 19.0.0
Max:
wersja 10 Min: 17.0.0
Max:

C#

Interfejs API i obsługiwane wersje Min. i .NET
wersja 12 Min: 14.2.0
Max:
wersja 11 Min: 12.1.0
Max:
wersja 10 Min: 11.0.0
Max:

PHP

Interfejs API i obsługiwane wersje Min/Max PHP
wersja 12 Min: 17.1.0
Max:
wersja 11 Min: 15.1.0
Max:
wersja 10 Min: 14.0.0
Max:

Python

API i obsługiwane wersje Min/Max Python
wersja 12 Min: 19.0.0
Max:
wersja 11 Min: 17.0.0
Max:
wersja 10 Min: 15.0.0
Max:

Ruby

Interfejs API i obsługiwane wersje Min/Max Ruby
wersja 12 Min: 20.0.0
Max: -
wersja 11 Min: 18.0.0
Max:
wersja 10 Min: 16.0.0
Max:

Perl

Interfejs API i obsługiwane wersje Min/Max Perl
wersja 12 Min: 14.0.0
Max:
wersja 11 Min: 12.0.0
Max:
wersja 10 Min: 10.0.0
Max:

Konfiguracja

Każda biblioteka klienta interfejsu API interfejsu API zawiera różne ustawienia konfiguracji i metody wczytywania, za pomocą których można dostosować jej działanie.

Oto zmienne środowiskowe, które są wspólne dla wszystkich bibliotek klienta, które można wczytać, aby skonfigurować ustawienia konfiguracji:

  • Biblioteka klienta
    • GOOGLE_ADS_CONFIGURATION_FILE_PATH: ścieżka do pliku konfiguracji.
  • OAuth2
    • Tryb aplikacji
      • GOOGLE_ADS_CLIENT_ID : ustaw tę wartość na identyfikator klienta OAuth2.
      • GOOGLE_ADS_CLIENT_SECRET : ustaw tę wartość na tajny klucz klienta OAuth2.
      • GOOGLE_ADS_REFRESH_TOKEN : ustaw tę wartość na wstępnie wygenerowany token odświeżania OAuth2, jeśli chcesz ponownie wykorzystać tokeny OAuth2. To ustawienie jest opcjonalne.
    • Tryb konta usługi
      • GOOGLE_ADS_JSON_KEY_FILE_PATH: ustaw tę wartość na ścieżkę pliku konfiguracji OAuth2.
      • GOOGLE_ADS_IMPERSONATED_EMAIL: ustaw tę wartość na adres e-mail konta, pod które się podszywasz.
  • Interfejs Google Ads API
    • GOOGLE_ADS_DEVELOPER_TOKEN : ustaw swój token programisty.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID : to identyfikator klienta upoważnionego klienta do użycia w żądaniu bez myślników (-).
    • GOOGLE_ADS_LINKED_CUSTOMER_ID : ten nagłówek jest wymagany tylko w przypadku metod aktualizowania zasobów encji po uzyskaniu zgody za pomocą połączonych kont w interfejsie Google Ads (zasób AccountLink w interfejsie Google Ads API). Ustaw tę wartość na identyfikator klienta dostawcy danych, który aktualizuje zasoby o podanym identyfikatorze klienta. Powinien być ustawiony bez myślników (-). Więcej informacji o połączonych kontach znajdziesz w Centrum pomocy.