Instalowanie i konfigurowanie klienta

Zalecamy korzystanie z bibliotek klienta interfejsu API Google w interfejsie Bid Manager API. nie muszą ręcznie przetwarzać żądań ani odpowiedzi HTTP. Interfejs API Google biblioteki klienckie zapewniają lepszą integrację językową, wyższy poziom bezpieczeństwa umożliwia nawiązywanie połączeń wymagających autoryzacji użytkownika.

Interfejs API Bid Managera został oparty na protokole HTTP i formacie JSON. Jeśli wolisz przetwarzać prośby możesz użyć dowolnego standardowego klienta HTTP.

Instalowanie biblioteki klienta

Oferujemy biblioteki klienta, które obsługują interfejs Bid Manager API w różnych języków programowania. Pełną listę bibliotek klienta można znaleźć w Przykłady i na karcie Biblioteki.

Przewodniki dla programistów interfejsu Bid Manager API zawierają fragmenty kodu dla tych trzech: języki:

• Java
• Python
• PHP

Pełne przykłady integracji w tych językach znajdziesz w przykładach interfejsu API usługi Bid Manager. repozytorium GitHub.

Skonfiguruj klienta

Dane logowania OAuth 2.0 i zainstalowany klient , możesz zacząć korzystać z interfejsu Bid Manager API. Oto jak to zrobić: autoryzuj i skonfiguruj klienta:

Java

1. Zaimportuj niezbędne biblioteki.

   import static java.nio.charset.StandardCharsets.UTF_8;
   import com.google.api.client.auth.oauth2.Credential;
   import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp;
   import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
   import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
   import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
   import com.google.api.client.googleapis.util.Utils;
   import com.google.api.services.doubleclickbidmanager.DoubleClickBidManager;
   import java.io.Reader;
   import java.nio.file.Files;
   import java.nio.file.Paths;

2. Wczytaj plik z tajnymi kluczami klienta i wygeneruj dane uwierzytelniające.

   Gdy pierwszy raz wykonasz ten krok, pojawi się prośba o zaakceptowanie autoryzacji w przeglądarce. Zanim zaakceptujesz zaproszenie, zaloguj się na konto Google z dostępem do Display &Video 360 Film 360. Twoja aplikacja zostanie autoryzowana uzyskać dostęp do danych w imieniu tego, z którego aktualnie korzystasz.

   // Read client secrets file.
   GoogleClientSecrets clientSecrets;
   try (Reader reader = Files.newBufferedReader(Paths.get(path-to-client-secrets-file), UTF_8)) {
     clientSecrets = GoogleClientSecrets.load(Utils.getDefaultJsonFactory(), reader);
   }
   
   // Generate authorization credentials.
   // Set up the authorization code flow.
   GoogleAuthorizationCodeFlow flow =
       new GoogleAuthorizationCodeFlow.Builder(
           Utils.getDefaultTransport(),
           Utils.getDefaultJsonFactory(),
           clientSecrets,
           oauth-scopes)
       .build();
   
   Credential credential =
       new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");

3. Utwórz autoryzowanego klienta interfejsu API.

   // Create authorized API client.
   DoubleClickBidManager service =
       new DoubleClickBidManager.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
           .setApplicationName("bidmanager-java-installed-app-sample")
           .build();

Python

1. Zaimportuj niezbędne biblioteki.

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient import discovery

2. Wczytaj plik z tajnymi kluczami klienta i wygeneruj dane uwierzytelniające.

   Gdy pierwszy raz wykonasz ten krok, pojawi się prośba o zaakceptowanie autoryzacji w przeglądarce. Zanim zaakceptujesz zaproszenie, zaloguj się na konto Google z dostępem do Display &Video 360 Film 360. Twoja aplikacja zostanie autoryzowana uzyskać dostęp do danych w imieniu tego, z którego aktualnie korzystasz.

   # Set up a flow object to create the credentials using the
   # client secrets file and OAuth scopes.
   credentials = InstalledAppFlow.from_client_secrets_file(
       path-to-client-secrets-file, oauth-scopes).run_local_server()

3. Utwórz autoryzowanego klienta interfejsu API.

   # Build the discovery document URL.
   discovery_url = f'https://doubleclickbidmanager.googleapis.com/$discovery/rest?version=v2'
   
   # Build the API service.
   service = discovery.build(
       'doubleclickbidmanager',
       'v2',
       discoveryServiceUrl=discovery_url,
       credentials=credentials)

PHP

W tym przykładzie zakładamy, że używasz języka PHP z wbudowanym serwerem WWW skonfigurowały Twoje dane logowania tak, aby przekierowywały na odpowiednią stronę internetową. Dla: ten kod w pliku index.php można uruchomić przy użyciu polecenie i dane logowania skonfigurowane pod kątem przekierowania do http://localhost:8000 po uwierzytelnianie:

php -S localhost:8000 -t ./

1. Pobierz i zainstaluj klienta PHP interfejsu Google API.

   Preferowana metoda to Composer:

   composer require google/apiclient:^2.12.1

   Pamiętaj, aby po zainstalowaniu dodać moduł automatycznego wczytywania.

   require_once '/path/to/your-project/vendor/autoload.php';

2. Utwórz obiekt Google_Client.

   $client = new Google_Client();

3. Skonfiguruj klienta, w razie potrzeby przekieruj na adres URL uwierzytelniania i pobierz token dostępu.

   Gdy pierwszy raz wykonasz ten krok, pojawi się prośba o zaakceptowanie autoryzacji w przeglądarce. Zanim zaakceptujesz zaproszenie, zaloguj się na konto Google z dostępem do Display &Video 360 Film 360. Twoja aplikacja zostanie autoryzowana uzyskać dostęp do danych w imieniu tego, z którego aktualnie korzystasz.

   // Set up the client.
   $client->setApplicationName('DBM API PHP Samples');
   $client->addScope(oauth-scope);
   $client->setAccessType('offline');
   $client->setAuthConfigFile(path-to-client-secrets-file);
   
   // If the code is passed, authenticate. If not, redirect to authentication page.
   if (isset($_GET['code'])) {
     $client->authenticate($_GET['code']);
   } else {
     $authUrl = $client->createAuthUrl();
     header('Location: ' . $authUrl);
   }
   
   // Exchange authorization code for an access token.
   $accessToken = $client->getAccessToken();
   $client->setAccessToken($accessToken);

4. Tworzenie klienta dla sieci reklamowej Usługa interfejsu Video 360 API.

   $service = new Google_Service_DoubleClickBidManager($client);