API'yi Kullanmaya Başlama

Bu dokümanda Google Bid Manager API'si. API, sorguları yönetmenize ve rapor meta verilerini almanıza olanak tanır.

Bid Manager API v2, kullanılabilen ve önerilen en son sürümdür sürümünü değil.

1. Başlamadan önce

Google Görüntülü Reklam Ağı Video 360 kavramları hakkında bilgi için Görüntülü Reklam ve Video 360 Yardım Merkezi ve kullanıcı arayüzü ile denemeler yapın.

2. Kimlik doğrulama için hazırlanma

Bid Manager API'yi kullanmaya başlamak için önce kurulum aracını kullanmanız gerekir. Bu araç, Google API Konsolu'nda proje oluşturma, API'yi etkinleştirme ve kimlik bilgileri oluşturma konusunda size rehberlik eder.

Henüz yapmadıysanız Kimlik bilgileri oluştur > OAuth istemci kimliği'ni tıklayarak OAuth 2.0 kimlik bilgilerinizi oluşturun. Bu istemci kimliğinizi Kimlik Bilgileri sayfasında görebilirsiniz. Müşteri kimliğini tıklayarak müşteri gizlisi, yönlendirme URI'leri, JavaScript kaynak adresi ve e-posta adresi gibi ayrıntıları görebilirsiniz.

Daha fazla bilgi için bkz. İstekleri Yetkilendirme

3. Bid Manager API'sini çağırma

Aşağıdaki sekmeler, çeşitli dillerde kodlama için hızlı başlangıç kılavuzları sağlar. Benzer örnek koda Bid Manager API Örnekleri reposunda da ulaşabilirsiniz.

JavaPythonPHP

  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 com.google.api.services.doubleclickbidmanager.model.ListQueriesResponse;
import com.google.api.services.doubleclickbidmanager.model.Query;
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 Görüntülü Reklam Ağı ve Video 360. Uygulamanız, şu anda oturum açmış olan hesap adına verilere erişme yetkisine sahip olur. 

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

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

    // Perform an operation.
// Call the API, getting a list of 10 queries.
ListQueriesResponse queriesResponse = service.queries().list().setPageSize(10).execute();

// Print them out.
System.out.println("Id\t\tName");
if (queriesResponse.getQueries().size() > 0) {
  for (int i = 0; i < queriesResponse.getQueries().size(); i++) {
    Query currentQuery = queriesResponse.getQueries().get(i);
    System.out.printf(
        "%s\t%s%n",
        currentQuery.getQueryId(),
        currentQuery.getMetadata().getTitle());
  }
} else {
  System.out.println("No queries exist.");
}

Bid Manager API'yi Java ile kullanma hakkında daha ayrıntılı bilgi için Bid Manager API örnekleri bölümündeki README dosyasını inceleyin.

  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 Görüntülü Reklam Ağı ve Video 360. Uygulamanız, şu anda oturum açmış olan hesap adına verilere erişme yetkisine sahip olur. 

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

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

    # Build and execute queries.listqueries request.
response = service.queries().list(pageSize='10').execute()

# Print queries out.
if 'queries' in response:
  print('Id\t\tName')
  for query in response['queries']:
    print('%s\t%s' % (query['queryId'], query['metadata']['title']))
else:
  print('No queries exist.')

Python ile Bid Manager API'sini kullanma hakkında daha ayrıntılı bilgi için bu sayfaya BENİOKU dosyasını Bid Manager API örnekleri.

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, bir index.php dosyasında bulunan 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'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 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 Görüntülü Reklam Ağı ve Video 360. Uygulamanız, şu anda oturum açmış olan hesap adına verilere erişme yetkisine sahip olur. 

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

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

    // Configure params for the Queries.listqueries request.
$optParams = array('pageSize' => 10);

// Execute the request.
$result = $service->queries->listQueries($optParams);

// Print the retrieved queries.
if (!empty($result->getQueries())) {
  print('<pre><p>Id Name</p>');
  foreach ($result->getQueries() as $query) {
    printf('<p>%s %s</p>', $query->queryId, $query->metadata->title);
  }
  print('</pre>');
} else {
  print '<p>No queries exist.</p>';
}

PHP ile Bid Manager API'sini kullanma hakkında daha ayrıntılı bilgi için bu sayfaya BENİOKU dosyasını Bid Manager API örnekleri.

4. Sonraki adımlar

İstemci kitaplığınız kullanıma hazır olduğuna göre referans dokümanlarını inceleyin ve uygulamanızı oluşturmaya başlayın.

Planlanmış raporları kullanma ve raporlamayla ilgili en iyi uygulamaları takip etme hakkında ek kılavuzlar da mevcuttur.