Bạn nên sử dụng các thư viện ứng dụng Google API với Display & Video 360 API. Bằng cách sử dụng thư viện ứng dụng, bạn không phải tạo yêu cầu HTTP và phân tích cú pháp phản hồi theo cách thủ công. Thư viện ứng dụng có thể cung cấp tính năng tích hợp ngôn ngữ tốt hơn, có mức độ bảo mật cao hơn và hỗ trợ thực hiện các lệnh gọi yêu cầu người dùng phải uỷ quyền.
Display & Video 360 API được xây dựng trên HTTP và JSON. Nếu muốn, bạn có thể sử dụng bất kỳ ứng dụng HTTP tiêu chuẩn nào để đưa ra yêu cầu và phân tích cú pháp phản hồi.
Cài đặt thư viện ứng dụng
Chúng tôi cung cấp các thư viện ứng dụng hỗ trợ Display & Video 360 API bằng nhiều ngôn ngữ lập trình. Để xem danh sách đầy đủ các thư viện ứng dụng, hãy xem trang Mẫu và thư viện của chúng tôi.
Hướng dẫn dành cho nhà phát triển Display & Video 360 API cung cấp các đoạn mã cho những ngôn ngữ sau:
Ngoài các đoạn mã trong hướng dẫn, chúng tôi còn cung cấp các ví dụ tích hợp đầy đủ bằng những ngôn ngữ này. Hãy xem kho lưu trữ GitHub về các ví dụ về Display & Video 360 API để biết các mẫu này.
Định cấu hình ứng dụng
Với thông tin xác thực OAuth 2.0 và thư viện ứng dụng đã cài đặt, bạn đã sẵn sàng sử dụng Display & Video 360 API. Sau đây là cách uỷ quyền và định cấu hình ứng dụng khách:
Java
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.displayvideo.v4.DisplayVideo; import com.google.api.services.displayvideo.v4.DisplayVideo.Advertisers; import com.google.api.services.displayvideo.v4.model.Advertiser; import com.google.api.services.displayvideo.v4.model.ListAdvertisersResponse; import java.io.Reader; import java.nio.file.Files; import java.nio.file.Paths;Tải tệp khoá bí mật của ứng dụng và tạo thông tin xác thực uỷ quyền.
Trong 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 lời nhắc uỷ quyền trong trình duyệt. Trước khi chấp nhận, hãy đảm bảo bạn đã đăng nhập bằng một Tài khoản Google có quyền truy cập vào Display & Video 360. Ứng dụng của bạn sẽ được uỷ quyền truy cập vào dữ liệu thay cho tài khoản hiện đang đăng nhập. Hãy xem hướng dẫn về khái niệm Quyền của người dùng của chúng tôi để biết thêm thông tin chi tiết.
// 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");Tạo một ứng dụng API được uỷ quyền.
// Create authorized API client. DisplayVideo service = new DisplayVideo.Builder(credential.getTransport(), credential.getJsonFactory(), credential) .setApplicationName("displayvideo-java-installed-app-sample") .build();
Python
Nhập các thư viện cần thiết.
from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient import discoveryTải tệp khoá bí mật của ứng dụng và tạo thông tin xác thực uỷ quyền.
Trong 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 lời nhắc uỷ quyền trong trình duyệt. Trước khi chấp nhận, hãy đảm bảo bạn đã đăng nhập bằng một Tài khoản Google có quyền truy cập vào Display & Video 360. Ứng dụng của bạn sẽ được uỷ quyền truy cập vào dữ liệu thay cho tài khoản hiện đang đăng nhập. Hãy xem hướng dẫn về khái niệm Quyền của người dùng của chúng tôi để biết thêm thông tin chi tiết.
# 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()Tạo một ứng dụng API được uỷ quyền.
# Build the discovery document URL. discovery_url = f'https://displayvideo.googleapis.com/$discovery/rest?version=v4' # Build the API service. service = discovery.build( 'displayvideo', 'v4', discoveryServiceUrl=discovery_url, credentials=credentials)
PHP
Mẫu này giả định rằng bạn đang chạy PHP bằng một máy chủ web tích hợp và đã định cấu hình thông tin đăng nhập để chuyển hướng đến trang web có liên quan. Ví dụ: mã này trong tệp index.php có thể chạy bằng lệnh và thông tin đăng nhập sau đây được định cấu hình để chuyển hướng đến http://localhost:8000 sau khi xác thực:
php -S localhost:8000 -t ./Tải xuống và cài đặt Google API PHP Client.
Phương thức ưu tiên là sử dụng Composer:
composer require google/apiclient:^2.18.2 google/apiclient-services:=0.396.0Sau khi cài đặt, hãy nhớ thêm trình tải tự động:
require_once '/path/to/your-project/vendor/autoload.php';Tạo một đối tượng Google_Client.
$client = new Google_Client();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.
Trong 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 lời nhắc uỷ quyền trong trình duyệt. Trước khi chấp nhận, hãy đảm bảo bạn đã đăng nhập bằng một Tài khoản Google có quyền truy cập vào Display & Video 360. Ứng dụng của bạn sẽ được uỷ quyền truy cập vào dữ liệu thay cho tài khoản hiện đang đăng nhập. Hãy xem hướng dẫn về khái niệm Quyền của người dùng của chúng tôi để biết thêm thông tin chi tiết.
// Set up the client. $client->setApplicationName('DV360 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);Tạo một ứng dụng cho dịch vụ Display & Video 360 API.
$service = new Google_Service_DisplayVideo($client);