תחילת העבודה

אפשר להשתמש ב-API ל-REST של Google Ad Manager כדי לקרוא את הנתונים של Ad Manager ולהריץ דוחות.

כדי לעזור לכם להתחיל, אנחנו מציעים ספריית לקוח ל-Java, בקרוב. כדי לשלוח את בקשת ה-API הראשונה, פועלים לפי השלבים הבאים:

קבלת גישה לרשת Ad Manager

אם עדיין אין לך חשבון, להירשם לחשבון Ad Manager חשבון.

הפעלת Ad Manager API

מפעילים את את Ad Manager API ב- פרויקט של מסוף Google API.

אמת

כל בקשות ה-API צריכות להיות מאומתות באמצעות OAuth2.

ספריות הלקוח של Ad Manager API ל-REST קוראות פרטי כניסה מ- 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

הגדרה של ספריית הלקוח

Java

ב-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

יצירת הבקשה הראשונה

Java

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.

Python

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