شروع شدن

از 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 ، این دستورالعمل‌ها را دنبال کنید.

حساب خدمات

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/keyfile.json

اعتبار کاربری

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);
      }
   }
}

نمونه های بیشتری را می توانید در GitHub پیدا کنید.

پایتون

from google.ads import admanager

client = admanager.NetworkServiceClient()

request = admanager.GetNetworkRequest(
     name="networks/NETWORK_CODE",
)

response = client.get_network(request=request)

print(response)

نمونه های بیشتری را می توانید در GitHub پیدا کنید.

CURL

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