شروع به کار

از Google Ad Manager API (نسخه بتا) برای خواندن داده‌های Ad Manager و اجرای گزارش‌ها استفاده کنید.

برای ایجاد اولین درخواست API، مراحل زیر را تکمیل کنید:

دسترسی به شبکه Ad Manager

اگر ازقبل حساب ندارید، برای حساب Ad Manager ثبت‌نام کنید.

فعال کردن «میانای برنامه‌سازی کاربردی Ad Manager»

Ad Manager API را در «پروژه کنسول Google API» خود فعال کنید.

اصالت‌سنجی

همه درخواست‌های API باید بااستفاده از OAuth2 اصالت‌سنجی شوند.

کتابخانه‌های کارخواه «میانای برنامه‌سازی کاربردی Ad Manager» اطلاعات اعتباری را از اطلاعات اعتباری پیش‌فرض برنامه می‌خوانند. می‌توانید این موارد را بااستفاده از متغیرهای محیطی یا 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

دات نت

کتابخانه کارخواه را از 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 را ببینید.

دات نت 

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;

/**
 * Retrieves 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