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

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.