Bắt đầu sử dụng API

Tài liệu này giải thích cách bắt đầu viết ứng dụng sử dụng toán tử API Trình quản lý giá thầu của Google. API này cho phép bạn quản lý Truy vấn và truy xuất Siêu dữ liệu Báo cáo.

API Trình quản lý giá thầu phiên bản 2 là phiên bản mới nhất hiện có và nên dùng .

1. Trước khi bắt đầu

Nếu bạn chưa quen với chiến dịch Hiển thị & của Google Các khái niệm của video 360, đọc Hiển thị và Trung tâm trợ giúp Video 360 và thử nghiệm với giao diện người dùng.

2. Chuẩn bị xác thực

Để bắt đầu sử dụng API Trình quản lý giá thầu, trước tiên, bạn cần sử dụng công cụ thiết lập. Công cụ này sẽ hướng dẫn bạn tạo dự án trong Google API Console, bật API và tạo thông tin đăng nhập.

Nếu bạn chưa làm như vậy, hãy tạo thông tin đăng nhập OAuth 2.0 bằng cách nhấp vào Tạo thông tin xác thực > Mã ứng dụng OAuth. Sau khi tạo thông tin xác thực, bạn có thể thấy mã ứng dụng khách của mình trên trang Thông tin xác thực. Nhấp chuột client ID để biết thông tin chi tiết, chẳng hạn như mật khẩu ứng dụng khách, URI chuyển hướng, JavaScript địa chỉ gốc và địa chỉ email của bạn.

Để biết thêm thông tin, hãy xem Uỷ quyền cho yêu cầu.

3. Gọi API Trình quản lý giá thầu

Các thẻ bên dưới cung cấp hướng dẫn bắt đầu nhanh về lập trình bằng nhiều ngôn ngữ. Tương đương bạn cũng có thể tìm thấy mã mẫu trong Ví dụ về Bid Manager API kho lưu trữ.

Java

  1. Nhập các thư viện cần thiết.

    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. Tải tệp bí mật ứng dụng khách và tạo thông tin xác thực uỷ quyền.

    Vào lần đầu tiên thực hiện bước này, bạn sẽ được yêu cầu chấp nhận một khoản uỷ quyền trên trình duyệt. Trước khi chấp nhận, hãy đảm bảo bạn đã đăng nhập bằng Tài khoản Google có quyền truy cập vào Mạng Hiển thị và Video 360. Ứng dụng của bạn sẽ được cấp phép để truy cập dữ liệu thay mặt cho bất kỳ tài khoản nào hiện đang đăng nhập. 

    // 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. Tạo một ứng dụng API được uỷ quyền.

    // Create authorized API client.
DoubleClickBidManager service =
    new DoubleClickBidManager.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
        .setApplicationName("bidmanager-java-installed-app-sample")
        .build();

  4. Thực hiện thao tác.

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

Để biết thêm thông tin chi tiết về cách sử dụng API Trình quản lý giá thầu với Java, tham chiếu đến ĐỌC trong Ví dụ về API Trình quản lý giá thầu.

Python

  1. Nhập các thư viện cần thiết.

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient import discovery

  2. Tải tệp bí mật ứng dụng khách và tạo thông tin xác thực uỷ quyền.

    Vào lần đầu tiên thực hiện bước này, bạn sẽ được yêu cầu chấp nhận một khoản uỷ quyền trên trình duyệt. Trước khi chấp nhận, hãy đảm bảo bạn đã đăng nhập bằng Tài khoản Google có quyền truy cập vào Mạng Hiển thị và Video 360. Ứng dụng của bạn sẽ được cấp phép để truy cập dữ liệu thay mặt cho bất kỳ tài khoản nào hiện đang đăng nhập. 

    # 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. Tạo một ứng dụng API được uỷ quyền.

    # 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. Thực hiện thao tác.

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

Để biết thêm thông tin chi tiết về cách sử dụng API Trình quản lý giá thầu với Python, tham chiếu đến ĐỌC trong Ví dụ về API Trình quản lý giá thầu.

PHP

Mẫu này giả định rằng bạn đang chạy PHP bằng máy chủ web tích hợp và đã định cấu hình thông tin xác thực của mình để chuyển hướng tới trang web có liên quan. Cho ví dụ: mã này, trong tệp index.php, có thể được chạy bằng cách sử dụng lệnh sau đã định cấu hình lệnh và thông tin đăng nhập để chuyển hướng đến http://localhost:8000 sau xác thực:

php -S localhost:8000 -t ./

  1. Tải và cài đặt Ứng dụng PHP của Google API.

    Phương thức ưu tiên là thông qua Composer: 

    composer require google/apiclient:^2.12.1

    Sau khi cài đặt, hãy nhớ bao gồm trình tải tự động 

    require_once '/path/to/your-project/vendor/autoload.php';

  2. Tạo đối tượng Google_Client.

    $client = new Google_Client();

  3. Thiết lập ứng dụng, chuyển hướng đến URL xác thực nếu cần và truy xuất mã truy cập.

    Vào lần đầu tiên thực hiện bước này, bạn sẽ được yêu cầu chấp nhận một khoản uỷ quyền trên trình duyệt. Trước khi chấp nhận, hãy đảm bảo bạn đã đăng nhập bằng Tài khoản Google có quyền truy cập vào Mạng Hiển thị và Video 360. Ứng dụng của bạn sẽ được cấp phép để truy cập dữ liệu thay mặt cho bất kỳ tài khoản nào hiện đang đăng nhập. 

    // 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. Xây dựng ứng dụng cho chiến dịch Hiển thị và Dịch vụ API Video 360.

    $service = new Google_Service_DoubleClickBidManager($client);

  5. Thực hiện thao tác.

    // 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>';
}

Để biết thêm thông tin chi tiết về cách sử dụng API Trình quản lý giá thầu với PHP, tham chiếu đến ĐỌC trong Ví dụ về API Trình quản lý giá thầu.

4. Các bước tiếp theo

Giờ đây, khi bạn đã thiết lập và chạy một thư viện ứng dụng, hãy khám phá tài liệu tham khảo và bắt đầu xây dựng việc triển khai.

Hướng dẫn bổ sung cũng có trên khai thác báo cáo định kỳ và theo các phương pháp báo cáo hay nhất.