استخدِم Google Ad Manager API (إصدار تجريبي) لقراءة بياناتك على "إدارة إعلانات Google" وإنشاء التقارير.
لإجراء طلب بيانات من واجهة برمجة التطبيقات الأول، أكمل الخطوات التالية:
الحصول على إذن الوصول إلى شبكة "إدارة الإعلانات"
إذا لم يكن لديك حساب، اشترِك للحصول على حساب في "مدير إعلانات Google".
تفعيل Ad Manager API
فعِّل Ad Manager API في مشروعك على Google API Console.
مصادقة
يجب المصادقة على جميع طلبات البيانات من واجهة برمجة التطبيقات باستخدام 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:
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