شروع شدن

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

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

به شبکه Ad Manager دسترسی پیدا کنید

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

Ad Manager API را فعال کنید

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

احراز هویت

تمام درخواست های 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

برای اطلاعات بیشتر در مورد انتخاب انواع اعتبارنامه و ایجاد اعتبارنامه، به راهنمای احراز هویت مراجعه کنید.

کتابخانه مشتری خود را تنظیم کنید

برای 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'

کتابخانه مشتری را از PyPi نصب کنید.

pip install google-ads-admanager

کتابخانه مشتری را از NuGet نصب کنید.

از دات نت CLI:

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 نصب کنید.

Gemfile:

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)

نمونه های بیشتری را می توانید در GitHub پیدا کنید. برای اطلاعات بیشتر درباره کتابخانه مشتری، راهنمای پایتون را ببینید.

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 پیدا کنید. برای اطلاعات بیشتر درباره کتابخانه مشتری، به راهنمای دات نت مراجعه کنید.

<?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 پیدا کنید.

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 پیدا کنید.

// 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 -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 https://admanager.googleapis.com/v1/networks/NETWORK_CODE