شروع شدن

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

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

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

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

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

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

احراز هویت

تمام درخواست های API باید با استفاده از OAuth2 احراز هویت شوند.

کتابخانه های سرویس گیرنده Ad Manager REST 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

اولین درخواست خود را مطرح کنید

جاوا 

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);
    }
  }
}
SyncGetNetwork.java

نمونه های بیشتری را می توانید در 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="name_value",
    )

    # Make the request
    response = client.get_network(request=request)

    # Handle the response
    print(response)
admanager_v1_generated_network_service_get_network_sync.py

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

CURL

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 https://admanager.googleapis.com/v1/networks/NETWORK_CODE