از رابط برنامهنویسی کاربردی (API) مدیریت تبلیغات گوگل (بتا) برای خواندن دادههای مدیریت تبلیغات و اجرای گزارشها استفاده کنید.
برای ایجاد اولین درخواست API خود، مراحل زیر را انجام دهید:
به یک شبکه مدیر تبلیغات دسترسی پیدا کنید
اگر هنوز حساب کاربری ندارید، برای یک حساب مدیریت تبلیغات ثبتنام کنید .
فعال کردن رابط برنامهنویسی کاربردی مدیریت تبلیغات (Ad Manager API)
رابط برنامهنویسی کاربردی مدیریت تبلیغات (Ad Manager API) را در پروژه کنسول API گوگل خود فعال کنید.
احراز هویت
تمام درخواستهای API باید با استفاده از OAuth2 تأیید اعتبار شوند.
کتابخانههای کلاینت Ad Manager API اعتبارنامهها را از Application Default Credentials میخوانند. میتوانید این موارد را با استفاده از متغیرهای محیطی یا gcloud تنظیم کنید.
حساب کاربری خدمات
لینوکس یا macOS
export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
ویندوز
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
برای اطلاعات بیشتر در مورد انتخاب انواع اعتبارنامه و ایجاد اعتبارنامه، به راهنمای احراز هویت مراجعه کنید.
کتابخانه کلاینت خود را راهاندازی کنید
جاوا
برای ماون:
<!-- pom.xml -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>ad-manager</artifactId>
<version>0.1.0</version>
</dependency>
برای گریدل:
implementation 'com.google.api-ads:ad-manager:0.1.0'
پایتون
کتابخانه کلاینت را از PyPi نصب کنید.
pip install google-ads-admanager
دات نت
کتابخانه کلاینت را از NuGet نصب کنید.
از رابط خط فرمان داتنت:
dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01
به عنوان مرجع بسته:
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />
پی اچ پی
کتابخانه کلاینت را از Composer نصب کنید.
composer require googleads/ad-manager
روبی
کتابخانه کلاینت را از RubyGems نصب کنید.
فایل جم:
gem 'google-ads-ad_manager', '~> 0.2.0'
نصب:
gem install google-ads-ad_manager
نود جی اس
کتابخانه کلاینت را از 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 پیدا کنید. برای اطلاعات بیشتر در مورد کتابخانه کلاینت، به راهنمای جاوا مراجعه کنید.
پایتون
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)
مثالهای بیشتر را میتوانید در گیتهاب پیدا کنید. برای اطلاعات بیشتر در مورد کتابخانه کلاینت، به راهنمای پایتون مراجعه کنید.
دات نت
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
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);
}
مثالهای بیشتر را میتوانید در گیتهاب پیدا کنید.
روبی
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
مثالهای بیشتر را میتوانید در گیتهاب پیدا کنید.
نود جی اس
// 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();
مثالهای بیشتر را میتوانید در گیتهاب پیدا کنید.
حلقه
curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://admanager.googleapis.com/v1/networks/NETWORK_CODE