İstemcinizi yükleme ve yapılandırma

Google API istemci kitaplıklarını Bid Manager API'si ile kullanmanızı öneririz. Böylece, HTTP isteklerini ve yanıtlarını manuel olarak işlemeniz gerekmez. Google API'si istemci kitaplıkları daha iyi dil entegrasyonu, daha yüksek güvenlik ve kullanıcı yetkilendirmesi gerektiren aramalar yapma desteği.

Bid Manager API'si, HTTP ve JSON üzerine kurulmuştur. İstekleri işlemeyi tercih ederseniz ve yanıtları manuel olarak almak için herhangi bir standart HTTP istemcisini kullanabilirsiniz.

İstemci kitaplığı yükleme

Bid Manager API'sini destekleyen istemci kitaplıkları sunuyoruz. programlama dilleri arasında. İstemci kitaplıklarının tam listesi için Örnekler ve kitaplıklar sekmesine gidin.

Bid Manager API geliştirici kılavuzları, aşağıdaki üçü için kod snippet'leri sağlar diller:

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

İstemcinizi yapılandırın

OAuth 2.0 kimlik bilgileri ve yüklü bir istemci ile) kitaplığını Bid Manager API'yi kullanmaya hazırsınız. Bunu nasıl yapacağınız aşağıda açıklanmıştır: istemcinizi yetkilendirin ve yapılandırın:

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. İstemci gizli anahtarı dosyasını yükleyin ve yetkilendirme kimlik bilgilerini oluşturun.

    Bu adımı ilk kez gerçekleştirdiğinizde yetkilendirmeyi kabul etmeniz istenir. istemi görüntülenir. Kabul etmeden önce Görüntülü Reklam Ağı ve Video 360. Uygulamanız yetkilendirilecek o anda oturum açılmış olan hesap adına verilere erişmek için kullanır. 

    // 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. İstemci gizli anahtarı dosyasını yükleyin ve yetkilendirme kimlik bilgilerini oluşturun.

    Bu adımı ilk kez gerçekleştirdiğinizde yetkilendirmeyi kabul etmeniz istenir. istemi görüntülenir. Kabul etmeden önce Görüntülü Reklam Ağı ve Video 360. Uygulamanız yetkilendirilecek o anda oturum açılmış olan hesap adına verilere erişmek için kullanır. 

    # 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ırmış olmanız gerekir. Örneğin, örneğin, bir index.php dosyasındaki bu kod, komut ve kimlik bilgilerinden sonra http://localhost:8000 adresine yönlendirecek şekilde yapılandırılmıştır kimlik doğrulama:

php -S localhost:8000 -t ./

  1. Google API PHP İstemcisini indirin ve 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. Bir Google_Client nesnesi oluşturun.

    $client = new Google_Client();

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

    Bu adımı ilk kez gerçekleştirdiğinizde yetkilendirmeyi kabul etmeniz istenir. istemi görüntülenir. Kabul etmeden önce Görüntülü Reklam Ağı ve Video 360. Uygulamanız yetkilendirilecek o anda oturum açılmış olan hesap adına verilere erişmek için kullanır. 

    // 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. Görüntülü Reklam Ağı ve Video 360 API hizmeti.

    $service = new Google_Service_DoubleClickBidManager($client);
Önceki
Kimlik bilgisi oluşturma
Sonraki
API isteği gönderme