Google Ad Manager API (베타)를 사용하여 Ad Manager 데이터를 읽고 보고서를 실행합니다.
첫 번째 API 요청을 하려면 다음 단계를 완료하세요.
Ad Manager 네트워크에 대한 액세스 권한 얻기
아직 계정이 없다면 Ad Manager 계정에 가입합니다.
Ad Manager API 사용 설정
Google API 콘솔 프로젝트에서 Ad Manager API를 사용 설정합니다.
인증
모든 API 요청은 OAuth2를 사용하여 인증해야 합니다.
Ad Manager API 클라이언트 라이브러리는 애플리케이션 기본 사용자 인증 정보에서 사용자 인증 정보를 읽습니다. 환경 변수 또는 gcloud를 사용하여 설정할 수 있습니다.
서비스 계정
Linux 또는 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
사용자 인증 정보 유형 선택 및 사용자 인증 정보 만들기에 관한 자세한 내용은 인증 가이드를 참고하세요.
클라이언트 라이브러리 설정
자바
Maven의 경우:
<!-- pom.xml -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>ad-manager</artifactId>
<version>0.1.0</version>
</dependency>
Gradle의 경우:
implementation 'com.google.api-ads:ad-manager:0.1.0'
Python
PyPi에서 클라이언트 라이브러리를 설치합니다.
pip install google-ads-admanager
.NET
NuGet에서 클라이언트 라이브러리를 설치합니다.
.NET CLI에서:
dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01
패키지 참조:
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />
PHP
Composer에서 클라이언트 라이브러리를 설치합니다.
composer require googleads/ad-manager
Ruby
RubyGems에서 클라이언트 라이브러리를 설치합니다.
Gemfile:
gem 'google-ads-ad_manager', '~> 0.2.0'
설치합니다.
gem install google-ads-ad_manager
Node.js
npm에서 클라이언트 라이브러리를 설치합니다.
명령줄에서 다음을 실행합니다.
npm install @google-ads/admanager
패키지 참조:
// package.json
"dependencies": {
"@google-ads/admanager": "^0.1.0"
}
첫 번째 요청하기
자바
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);
}
}
}
더 많은 예시는 GitHub에서 확인할 수 있습니다. 클라이언트 라이브러리에 관한 자세한 내용은 Java 가이드를 참고하세요.
Python
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)
더 많은 예시는 GitHub에서 확인할 수 있습니다. 클라이언트 라이브러리에 관한 자세한 내용은 Python 가이드를 참고하세요.
.NET
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);
}
}
더 많은 예시는 GitHub에서 확인할 수 있습니다. 클라이언트 라이브러리에 관한 자세한 내용은 .NET 가이드를 참고하세요.
PHP
<?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);
}
더 많은 예시는 GitHub에서 확인할 수 있습니다.
Ruby
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
더 많은 예시는 GitHub에서 확인할 수 있습니다.
Node.js
// 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();
더 많은 예시는 GitHub에서 확인할 수 있습니다.
cURL
curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://admanager.googleapis.com/v1/networks/NETWORK_CODE