İstemcinizi yükleme ve yapılandırma

HTTP isteklerini ve yanıtlarını manuel olarak işlemeniz gerekmemesi için Google API istemci kitaplıklarını Bid Manager API ile birlikte kullanmanızı öneririz. Google API istemci kitaplıkları daha iyi dil entegrasyonu ve daha yüksek güvenlik sağlamanın yanı sıra kullanıcı yetkilendirmesi gerektiren telefon aramalarının yapılmasını da destekler.

Bid Manager API, HTTP ve JSON üzerine kuruludur. İstekleri ve yanıtları manuel olarak işlemeyi tercih ederseniz herhangi bir standart HTTP istemcisini kullanabilirsiniz.

İstemci kitaplığı yükleme

Çeşitli programlama dillerinde Bid Manager API'yi destekleyen istemci kitaplıkları sunuyoruz. İstemci kitaplıklarının tam listesi için Örnekler ve kitaplıklar sekmesine bakın.

Bid Manager API geliştirici kılavuzlarında aşağıdaki üç dil için kod snippet'leri sağlanır:

Bu dillerdeki tam entegrasyon örnekleri için Bid Manager API örnekleri GitHub deposuna bakın.

İstemcinizi yapılandırma

OAuth 2.0 kimlik bilgileri ve yüklü bir istemci kitaplığı ile Bid Manager 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.doubleclickbidmanager.DoubleClickBidManager;
    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.

    // 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.
    DoubleClickBidManager service =
        new DoubleClickBidManager.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
            .setApplicationName("bidmanager-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.

    # 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://doubleclickbidmanager.googleapis.com/$discovery/rest?version=v2'
    
    # Build the API service.
    service = discovery.build(
        'doubleclickbidmanager',
        'v2',
        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'dır:

    composer require google/apiclient:^2.12.1

    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.

    // 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. Display & Video 360 API hizmeti için bir istemci oluşturun.

    $service = new Google_Service_DoubleClickBidManager($client);