Biblioteki klienckie

Nasze biblioteki klienta zapewniają ogólne widoki i podstawowe elementy interfejsu API Google Ads, ułatwiając szybkie programowanie aplikacji. Jeśli nie znasz jeszcze interfejsu API, zalecamy rozpoczęcie od niego.

Biblioteka klienta Źródło Rozkład 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

Poniższa tabela zawiera listę konkretnych wersji biblioteki, które obsługują poszczególne dostępne wersje interfejsu API.

Wersja interfejsu API Wersja biblioteki Pythona Wersja biblioteki Ruby Wersja biblioteki PHP Wersja biblioteki Java Wersja biblioteki .NET Wersja biblioteki Perl
wersja 11 >= 17,0.0 >= 18,0,0 >=15,1,0 >= 19.0.0 >= 12,1,0 >= 12,0.0
wersja 10 >= 15,0,0 >= 16,0.0 >= 14,0,0 >= 17,0.0 >= 11,0.0 >= 10,0,0
wersja 9 >= 14,1,0 >= 15,0,0 >= 12,1,0 >= 16,0.0 >= 10,2,0 >= 9,2,0

Konfiguracja

Każda biblioteka klienta interfejsu API Google Ads zawiera różne ustawienia konfiguracji i metody wczytywania, których możesz użyć, aby dostosować jej działanie.

Oto zmienne środowiskowe wspólne dla wszystkich bibliotek klienta, które można wczytać, aby określić 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 używać tych tokenów ponownie. To ustawienie jest opcjonalne.
    • Tryb konta usługi
      • GOOGLE_ADS_JSON_KEY_FILE_PATH : ustaw tę wartość na ścieżkę pliku JSON konfiguracji OAuth2.
      • GOOGLE_ADS_IMPERSONATED_EMAIL : ustaw tę wartość na adres e-mail konta, którego rolę odgrywasz.
  • Interfejs Google Ads API
    • GOOGLE_ADS_DEVELOPER_TOKEN: użyj tego ustawienia.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID : to identyfikator klienta autoryzowanego klienta do użycia w żądaniu, bez łączników (-).
    • GOOGLE_ADS_LINKED_CUSTOMER_ID : ten nagłówek jest wymagany tylko w przypadku metod aktualizowania zasobów encji po uzyskaniu uprawnień 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 określonego identyfikatora klienta. Powinien zostać ustawiony bez łączników (-). Więcej informacji o połączonych kontach znajdziesz w Centrum pomocy.