Wprowadzenie

Interfejs API typu REST Google Ad Managera służy do odczytywania danych z Ad Managera i generowania raportów.

Aby ułatwić rozpoczęcie pracy, oferujemy bibliotekę klienta dla języka Java z większą liczbą języki będą dostępne wkrótce. Aby wysłać pierwsze żądanie do interfejsu API, wykonaj czynności opisane poniżej.

Uzyskiwanie dostępu do sieci Ad Managera

Jeśli jeszcze nie masz konta Google, zarejestruj się w usłudze Ad Manager koncie.

Włączanie interfejsu Ad Manager API

Włącz Interfejs API Ad Managera w Projekt w Konsoli interfejsów API Google.

Uwierzytelnij

Wszystkie żądania do interfejsu API muszą być uwierzytelnione za pomocą protokołu OAuth2.

Biblioteki klienta interfejsu API REST Ad Managera odczytują dane logowania z Domyślne uwierzytelnianie aplikacji. Aby ustawić za pomocą zmiennych środowiskowych lub gcloud, postępuj zgodnie z tymi instrukcjami.

Konto usługi 

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/keyfile.json

Dane logowania użytkownika 

gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
# End user credentials must specify the cloud project where the API is enabled.
gcloud auth application-default set-quota-project PROJECT_ID

Konfigurowanie biblioteki klienta

Java

Maven:

<!-- pom.xml -->
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>ad-manager</artifactId>
   <version>0.1.0</version>
</dependency>

W przypadku Gradle:

implementation 'com.google.api-ads:ad-manager:0.1.0'

Python

Zainstaluj bibliotekę klienta z PyPi.

pip install google-ads-admanager

Prześlij pierwszą prośbę

Java 

import com.google.ads.admanager.v1.GetNetworkRequest;
import com.google.ads.admanager.v1.Network;
import com.google.ads.admanager.v1.NetworkName;
import com.google.ads.admanager.v1.NetworkServiceClient;

public class SyncGetNetwork {

   public static void main(String[] args) throws Exception {
      syncGetNetwork();
   }

   public static void syncGetNetwork() throws Exception {
      try (NetworkServiceClient networkServiceClient = NetworkServiceClient.create()) {
         GetNetworkRequest request =
            GetNetworkRequest.newBuilder()
               .setName(NetworkName.of("NETWORK_CODE").toString())
               .build();
         Network response = networkServiceClient.getNetwork(request);
      }
   }
}

Więcej przykładów znajdziesz na GitHub.

Python 

from google.ads import admanager

client = admanager.NetworkServiceClient()

request = admanager.GetNetworkRequest(
     name="networks/NETWORK_CODE",
)

response = client.get_network(request=request)

print(response)

Więcej przykładów znajdziesz na GitHub.

cURL 

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 https://admanager.googleapis.com/v1/networks/NETWORK_CODE