İstemcinizi yükleme ve yapılandırma

Display & Video 360 API ile Google API istemci kitaplıklarını kullanmanızı öneririz. İstemci kitaplıklarını kullanarak HTTP isteklerini manuel olarak oluşturmanız ve yanıtları ayrıştırmanız gerekmez. İstemci kitaplıkları daha iyi dil entegrasyonu ve daha yüksek güvenlik sağlamanın yanı sıra kullanıcı yetkilendirmesi gerektiren çağrıların yapılmasını da destekler.

Display & Video 360 API'si HTTP ve JSON üzerine kuruludur. İsterseniz istekte bulunmak ve yanıtları ayrıştırmak için herhangi bir standart HTTP istemcisini kullanabilirsiniz.

İstemci kitaplığı yükleme

Display & Video 360 API'yi destekleyen istemci kitaplıklarını çeşitli programlama dillerinde sunuyoruz. İstemci kitaplıklarının tam listesi için Örnekler ve Kitaplıklar sayfamıza bakın.

Display & Video 360 API geliştirici kılavuzlarında aşağıdaki diller için kod snippet'leri sağlanır:

• Java
• Python
• PHP

Rehberlerimizdeki kod snippet'lerinin yanı sıra bu dillerde tam entegrasyon örnekleri de sunuyoruz. Bu örnekler için Display & Video 360 API örnekleri GitHub deposuna bakın.

İstemcinizi yapılandırma

OAuth 2.0 kimlik bilgileri ve yüklü bir istemci kitaplığı ile Display & Video 360 API'yi kullanmaya hazırsınız. İstemcinizi yetkilendirme ve yapılandırma adımları aşağıda açıklanmıştır:

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. Gizli bilgi dosyası yükleyin ve yetkilendirme kimlik bilgileri 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çılmış olan hesabın adına verilere erişmek için yetkilendirilir. Daha fazla bilgi için Kullanıcı İzinleri kavramı rehberimize göz atın.

   // 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();
   

Python

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

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient import discovery
   

2. Gizli bilgi dosyası yükleyin ve yetkilendirme kimlik bilgileri 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çılmış olan hesabın adına verilere erişmek için yetkilendirilir. Daha fazla bilgi için Kullanıcı İzinleri kavramı rehberimize göz atın.

   # 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)
   

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 doğrulama işleminden sonra http://localhost:8000 adresine yönlendirecek şekilde yapılandırılmış kimlik bilgileri kullanılarak çalıştırılabilir:

php -S localhost:8000 -t ./

1. Google API PHP İstemcisi'ni indirip yükleyin.

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

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

   Yüklendikten 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çılmış olan hesabın adına verilere erişmek için yetkilendirilir. Daha fazla bilgi için Kullanıcı İzinleri kavramı rehberimize göz atın.

   // 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 bir istemci oluşturun.

   $service = new Google_Service_DisplayVideo($client);