İstemcinizi yapılandırma

OAuth 2.0 kimlik bilgileri oluşturulduktan ve istemci kitaplığı yüklendikten sonra Display & Video 360 API'yi kullanmaya başlayabilirsiniz. Aşağıdaki hızlı başlangıç kılavuzunu uygulayarak istemcinizi nasıl yetkilendireceğinizi, yapılandıracağınızı ve ilk isteğinizi nasıl göndereceğinizi öğrenin.

Java

1. Gerekli kitaplıkları içe aktarın.

   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.displayvideo.v4.DisplayVideo;
   import com.google.api.services.displayvideo.v4.DisplayVideo.Advertisers;
   import com.google.api.services.displayvideo.v4.model.Advertiser;
   import com.google.api.services.displayvideo.v4.model.ListAdvertisersResponse;
   import java.io.Reader;
   import java.nio.file.Files;
   import java.nio.file.Paths;
   

2. İstemci gizli anahtarı dosyasını yükleyin ve yetkilendirme kimlik bilgilerini oluşturun.

   Bu adımı ilk kez gerçekleştirdiğinizde, tarayıcınızda bir yetkilendirme istemini kabul etmeniz istenir. Kabul etmeden önce Display & Video 360'a erişimi olan bir Google Hesabı ile oturum açtığınızdan emin olun. Uygulamanız, şu anda oturum açmış olan hesap adına verilere erişme yetkisine sahip olur. Display & Video 360 kullanıcı izinleri hakkında daha fazla bilgi için İzin İstekleri kılavuzumuzu inceleyin.

   // 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. Yetkili bir API istemcisi oluşturun.

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

4. Bir işlem gerçekleştirin.

   // Perform an operation.
   // Retrieve and print the first ten advertisers under a partner.
   ListAdvertisersResponse response =
       service
           .advertisers()
           .list()
           .setPartnerId(partner-id)
           .setPageSize(10)
           .execute();
   if (response.getAdvertisers().size() > 0) {
     for (int i = 0; i < response.getAdvertisers().size(); i++) {
       System.out.printf(
           "ID: %s Display Name: %s%n",
           response.getAdvertisers().get(i).getAdvertiserId(),
           response.getAdvertisers().get(i).getDisplayName());
     }
   } else {
     System.out.print("No advertisers found.");
   }
   

Python

1. Gerekli kitaplıkları içe aktarın.

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient import discovery
   

2. İstemci gizli anahtarı dosyasını yükleyin ve yetkilendirme kimlik bilgilerini oluşturun.

   Bu adımı ilk kez gerçekleştirdiğinizde, tarayıcınızda bir yetkilendirme istemini kabul etmeniz istenir. Kabul etmeden önce Display & Video 360'a erişimi olan bir Google Hesabı ile oturum açtığınızdan emin olun. Uygulamanız, şu anda oturum açmış olan hesap adına verilere erişme yetkisine sahip olur. Display & Video 360 kullanıcı izinleri hakkında daha fazla bilgi için İzin İstekleri kılavuzumuzu inceleyin.

   # 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. Yetkili bir API istemcisi oluşturun.

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

4. Bir işlem gerçekleştirin.

   # Build advertisers.list request.
   request = service.advertisers().list(
       partnerId=partner-id, pageSize='10')
   
   # Execute request.
   response = request.execute()
   
   # Print response.
   if len(response['advertisers']) > 0:
     for advertiser in response['advertisers']:
       print(f'ID: {advertiser["advertiserId"]} Display Name: {advertiser["displayName"]}')
   else:
     print('No advertisers found.')
   

PHP

Bu örnekte, PHP'yi yerleşik bir web sunucusuyla çalıştırdığınız ve kimlik bilgilerinizi ilgili web sayfasına yönlendirecek şekilde yapılandırdığınız varsayılmaktadır. Örneğin, index.php dosyasındaki bu kod, aşağıdaki komut ve kimlik bilgileri kullanılarak çalıştırılabilir. Bu kimlik bilgileri, kimlik doğrulamasından sonra http://localhost:8000 adresine yönlendirilecek şekilde yapılandırılmıştır:

php -S localhost:8000 -t ./

1. Google API PHP istemcisini indirip yükleyin.

   Tercih edilen yöntem Composer'ı kullanmaktır:

   composer require google/apiclient:^2.18.2 google/apiclient-services:=0.396.0

   Yükledikten sonra otomatik yükleyiciyi eklediğinizden emin olun:

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

2. Google_Client nesnesi oluşturun.

   $client = new Google_Client();
   

3. İstemciyi ayarlayın, gerekirse kimlik doğrulama URL'sine yönlendirin ve erişim jetonu alın.

   Bu adımı ilk kez gerçekleştirdiğinizde, tarayıcınızda bir yetkilendirme istemini kabul etmeniz istenir. Kabul etmeden önce Display & Video 360'a erişimi olan bir Google Hesabı ile oturum açtığınızdan emin olun. Uygulamanız, şu anda oturum açmış olan hesap adına verilere erişme yetkisine sahip olur. Display & Video 360 kullanıcı izinleri hakkında daha fazla bilgi için İzin İstekleri kılavuzumuzu inceleyin.

   // Set up the client.
   $client->setApplicationName('DV360 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. Display & Video 360 API hizmeti için istemci oluşturun.

   $service = new Google_Service_DisplayVideo($client);
   

5. Bir işlem gerçekleştirin.

   // Configure params for the advertisers.list request.
   $optParams = array('pageSize' => 10, 'partnerId' => partner-id);
   
   // Execute the request.
   $result = $service->advertisers->listAdvertisers($optParams);
   
   // Print the retrieved advertisers.
   if (!empty($result->getAdvertisers())) {
     print('<pre>');
     foreach ($result->getAdvertisers() as $advertiser) {
       printf('<p>ID: %s, Display Name: %s</p>', $advertiser->advertiserId, $advertiser->displayName);
     }
     print('</pre>');
   } else {
     print '<p>No advertisers found.</p>';
   }