Sử dụng API Google Ad Manager (Bản thử nghiệm) để đọc dữ liệu Ad Manager và chạy báo cáo.
Để tạo yêu cầu API đầu tiên, hãy hoàn thành các bước sau:
Có quyền truy cập vào mạng Ad Manager
Nếu bạn chưa có tài khoản, hãy đăng ký tài khoản Ad Manager.
Bật API Ad Manager
Bật Ad Manager API trong Dự án Google API Console.
Xác thực
Tất cả các yêu cầu API phải được xác thực bằng OAuth2.
Thư viện ứng dụng API Ad Manager đọc thông tin xác thực từ Thông tin xác thực mặc định của ứng dụng. Bạn có thể thiết lập các biến này bằng cách sử dụng biến môi trường hoặc gcloud.
Linux hoặc macOS
export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Windows
set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
# End user credentials must specify the cloud project where the API is enabled.
gcloud auth application-default set-quota-project PROJECT_ID
Để biết thêm thông tin về cách chọn loại thông tin xác thực và tạo thông tin xác thực, hãy xem hướng dẫn xác thực.
Thiết lập thư viện ứng dụng
Đối với Maven:
<!-- pom.xml -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>ad-manager</artifactId>
<version>0.1.0</version>
</dependency>
Đối với Gradle:
implementation 'com.google.api-ads:ad-manager:0.1.0'
Cài đặt thư viện ứng dụng từ PyPi.
pip install google-ads-admanager
Cài đặt thư viện ứng dụng từ NuGet.
Từ .NET CLI:
dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01
Dưới dạng tham chiếu gói:
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />
Cài đặt thư viện ứng dụng từ Composer.
composer require googleads/ad-manager
Cài đặt thư viện ứng dụng từ RubyGems.
Gemfile:
gem 'google-ads-ad_manager', '~> 0.2.0'
Cài đặt:
gem install google-ads-ad_manager
Cài đặt thư viện ứng dụng từ npm.
Trên dòng lệnh:
npm install @google-ads/admanager
Dưới dạng tham chiếu gói:
// package.json
"dependencies": {
"@google-ads/admanager": "^0.1.0"
}
Tạo yêu cầu đầu tiên
import com.google.ads.admanager.v1.GetNetworkRequest;
import com.google.ads.admanager.v1.Network;
import com.google.ads.admanager.v1.NetworkName;
import com.google.ads.admanager.v1.NetworkServiceClient;
public class SyncGetNetwork {
public static void main(String[] args) throws Exception {
syncGetNetwork();
}
public static void syncGetNetwork() throws Exception {
try (NetworkServiceClient networkServiceClient = NetworkServiceClient.create()) {
GetNetworkRequest request =
GetNetworkRequest.newBuilder()
.setName(NetworkName.of("NETWORK_CODE ").toString())
.build();
Network response = networkServiceClient.getNetwork(request);
}
}
}
Bạn có thể xem thêm ví dụ trên GitHub. Để biết thêm thông tin về thư viện ứng dụng, hãy xem hướng dẫn về Java.
from google.ads import admanager_v1
def sample_get_network():
# Create a client
client = admanager_v1.NetworkServiceClient()
# Initialize request argument(s)
request = admanager_v1.GetNetworkRequest(
name="networks/NETWORK_CODE ",
)
# Make the request
response = client.get_network(request=request)
# Handle the response
print(response)
Bạn có thể xem thêm ví dụ trên GitHub. Để biết thêm thông tin về thư viện ứng dụng, hãy xem hướng dẫn về Python.
using Google.Ads.AdManager.V1;
public sealed partial class GeneratedNetworkServiceClientSnippets
{
public void GetNetwork()
{
// Create client
NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
// Initialize request argument(s)
string name = "networks/NETWORK_CODE ";
// Make the request
Network response = networkServiceClient.GetNetwork(name);
}
}
Bạn có thể xem thêm ví dụ trên GitHub. Để biết thêm thông tin về thư viện ứng dụng, hãy xem hướng dẫn về.NET.
<?php
use Google\Ads\AdManager\V1\Client\NetworkServiceClient;
use Google\Ads\AdManager\V1\GetNetworkRequest;
use Google\Ads\AdManager\V1\Network;
use Google\ApiCore\ApiException;
/**
* API to retrieve a Network object.
*
* @param string $formattedName Resource name of Network.
* Format: networks/{network_code}
* Please see {@see NetworkServiceClient::networkName()} for help formatting this field.
*/
function get_network_sample(string $formattedName): void
{
// Create a client.
$networkServiceClient = new NetworkServiceClient();
// Prepare the request message.
$request = (new GetNetworkRequest())
->setName($formattedName);
// Call the API and handle any network failures.
try {
/** @var Network $response */
$response = $networkServiceClient->getNetwork($request);
printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
} catch (ApiException $ex) {
printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
}
}
/**
* Helper to execute the sample.
*
*/
function callSample(): void
{
$formattedName = NetworkServiceClient::networkName('NETWORK_CODE ');
get_network_sample($formattedName);
}
Bạn có thể xem thêm ví dụ trên GitHub.
require "google/ads/ad_manager/v1"
def get_network
# Create a client object. The client can be reused for multiple calls.
client = Google::Ads::AdManager::V1::NetworkService::Rest::Client.new
# Create a request. To set request fields, pass in keyword arguments.
request = Google::Ads::AdManager::V1::GetNetworkRequest.new(:name => 'networks/NETWORK_CODE )'
# Call the get_network method.
result = client.get_network request
# The returned object is of type Google::Ads::AdManager::V1::Network.
p result
end
Bạn có thể xem thêm ví dụ trên GitHub.
// Resource name of the Network
const name = 'networks/NETWORK_CODE '
// Imports the Admanager library
const {NetworkServiceClient} = require('@google-ads/admanager').v1;
// Instantiates a client
const admanagerClient = new NetworkServiceClient();
async function callGetNetwork() {
// Construct request
const request = {
name,
};
// Run request
const response = await admanagerClient.getNetwork(request);
console.log(response);
}
callGetNetwork();
Bạn có thể xem thêm ví dụ trên GitHub.
curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://admanager.googleapis.com/v1/networks/NETWORK_CODE