Wprowadzenie

Zalecamy używanie biblioteki klienta z oprogramowaniem Apache Maven (lub Gradle).

Tworzenie nowego projektu Maven/Gradle

Utwórz nowy projekt Maven/Gradle w wybranym IDE. Nasze artefakty są opublikowane w centrum Maven .

Zależność Maven:

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>33.0.0</version>
</dependency>

Zależność Gradle to:

implementation 'com.google.api-ads:google-ads:33.0.0'

Możesz też utworzyć plik na podstawie źródła. Na potrzeby tego zakładamy, że masz projekt z wymaganymi zależnościami i dostępności informacji.

Uzyskiwanie danych logowania do uwierzytelniania za pomocą interfejsu API

Dostęp do interfejsu Google Ads API wymaga danych logowania OAuth i współpracy z programistą interfejsu Google Ads API token. Z tej sekcji dowiesz się, co to są, jak i w jaki sposób uzyskane.

Token programisty (na potrzeby dostępu do interfejsu API)

Token programisty jest połączony z kontem menedżera. konta i można znaleźć w interfejsie internetowym Google Ads.

Chociaż token programisty jest połączony z kontem menedżera, nie zapewnia dostępu do tego konta. Zamiast tego token programisty przyznaje dostęp a dostęp na poziomie konta odbywa się przez OAuth.

dane logowania OAuth (dostęp do kont Google Ads),

Aby autoryzować użytkowników konta Google z dostępem do kont Google Ads: musi podać zestaw danych logowania OAuth.

Najczęściej używane są 2 przepływy OAuth: aplikacja komputerowa (zainstalowana). lub aplikacji internetowej. Główna różnica między nimi polega na tym, że aplikacje komputerowe muszą otwórz przeglądarkę systemową i podaj identyfikator URI lokalnego przekierowania, by obsługiwać odpowiedzi serwera autoryzacji Google, natomiast aplikacje internetowe mogą przekierowywać przeglądarki innej firmy, aby dokończyć autoryzację i wysłać dane logowania z powrotem do serwera. Biblioteka obsługuje również rzadziej używane konto usługi przepływu danych.

W przypadku autoryzacji z użyciem własnych danych logowania (proces w aplikacji komputerowej)
Zapoznaj się z aplikacją komputerową OAuth przepływu danych. Dane te obejmują wszystkie informacje potrzebne do autoryzacji przy użyciu własnych danych logowania.
Autoryzowanie jako zewnętrzny użytkownik Google (przepływ internetu)
Zapoznaj się z procesem tworzenia aplikacji internetowej OAuth. Ten zawiera przykład konfigurowania autoryzacji OAuth dla dowolnych firm zewnętrznych użytkowników.
Autoryzowanie jako użytkownik domeny Google Apps (przepływ konta usługi)
Zapoznaj się z informacjami na temat konta usługi OAuth przepływu danych. To jest przykład tego, jak skonfigurować autoryzację OAuth dla użytkowników domeny Google Apps.

Jeśli masz dostęp do konta klienta Google Ads przez menedżera Google Ads konta, musisz także podać identyfikator klienta logowania zgodnie z poniższymi instrukcjami.

Login klienta (aby uzyskać dostęp do kont Google Ads z poziomu konta menedżera)

Opcjonalnie podaj identyfikator klienta konta menedżera, które daje dostęp do konta wyświetlania reklam. Musisz go określić, jeśli masz dostęp do klienta konto jest zarządzane przez konto menedżera. Nie trzeba określać wszystkich menedżerów na ścieżce do identyfikatora klienta, ale tylko identyfikator najwyższego poziomu, są używane na potrzeby uprawnień dostępu. Aby uzyskać więcej informacji, zapoznaj się z powiązanymi dokumentacji.

Skonfiguruj bibliotekę klienta za pomocą swoich danych logowania

Możesz skonfigurować bibliotekę klienta za pomocą pliku konfiguracji zmiennych środowiskowych lub automatycznie. W tym przewodniku wykorzystamy i skupić się na przepływach danych na komputerach i w internecie. Za pomocą pliku konfiguracji jest zwykle dobrym rozwiązaniem, gdy masz tylko jeden zestaw tagów dane logowania (np. zarządzasz kontami należącymi do jednego menedżera).

Utwórz plik ~/ads.properties o takiej zawartości:

api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE

Zastąp zmienne danymi logowania uzyskanymi w poprzednim kroku.

Poza tym, jeśli token odświeżania jest przeznaczony dla konta menedżera, określ identyfikator klienta tego konta jako klienta logowania:

api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

Zweryfikuj dane logowania

Aby upewnić się, że wszystko jest skonfigurowane prawidłowo, uruchomimy metodę GetKampanie przykład.

Najpierw przejdź do katalogu google-ads-examples.

$ cd google-ads-examples

Ten przykład wymaga parametru --customerId, w którym wartością jest Twoja identyfikator klienta konta Google Ads bez myślników.

Aby uruchomić Gradle:

$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

Zobacz inne przykłady

Pakiet przykładów w: google-ads-examples zawiera kilka przydatnych przykładów. Większość przykładów wymaga . Parametry możesz przekazywać jako argumenty (zalecane) lub zmień w kodzie źródłowym wartości INSERT_XXXXX_HERE. Aby wyświetlić instrukcję użytkowania na przykład przekazać --help jako jedyny argument.

Z Gradle:

$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --help"

Możesz też użyć zadania listExamples w Gradle, aby wyświetlić listę wszystkich przykładów, przykłady w podkatalogu lub przykłady, w których opis zawiera wyszukiwane hasło. .

# List all examples:
$ ./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
$ ./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
$ ./gradlew -q listExamples --searchTerm='Performance Max'