Şu anda rapor türlerinin bir kısmını çevrimdışı raporlamadan anında raporlamaya taşıyoruz. Bir kullanıcı taşındıktan sonra, queries.list yanıtları mevcut anlık raporları içerir. Daha fazla bilgi edinmek için blog yayınımızı inceleyebilirsiniz.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

API'yi Kullanmaya Başlama

Bu dokümanda Google Bid Manager API'si. API, reklam öğelerinin Sorgular ve alma Rapor meta verileri.

Bid Manager API v2, sunulan 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'sini kullanmaya başlamak için önce kullan kurulum aracını kullanın. Bu araç, Google API Konsolu, API'yi etkinleştirme ve kimlik bilgileri oluşturma.

Henüz yapmadıysanız aşağıdaki bağlantıyı tıklayarak OAuth 2.0 kimlik bilgilerinizi oluşturun: Kimlik bilgileri oluştur > OAuth istemci kimliği. Bu istemci kimliğinizi Kimlik Bilgileri sayfasında görebilirsiniz. Sonraki slayta geçin (ör. istemci gizli anahtarı, yönlendirme URI'leri, JavaScript) ayrıntılar için istemci kimliğini kaynak adresi ve e-posta adresi.

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 kod deposudur.

Java

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;

İ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");

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

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.");
}

Java 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.

Python

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

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient import discovery

İ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()
```

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)

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.

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 ./

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';
```
.
Bir Google_Client nesnesi oluşturun.
```
$client = new Google_Client();
```

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

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

Görüntülü Reklam Ağı ve Video 360 API hizmeti.

$service = new Google_Service_DoubleClickBidManager($client);

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

Artık çalışan bir istemci kitaplığınız olduğuna göre referansı inceleyin. uygulamanızı oluşturmaya başlayın.

Şurada da ek kılavuzlar mevcuttur: planlanmış raporlardan yararlanma ve raporlamayla ilgili en iyi uygulamaları izleyin.