תחילת העבודה

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

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

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

אם עדיין אין לכם חשבון, נרשמים לחשבון Ad Manager.

הפעלת Ad Manager API

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

אמת

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

ספריות הלקוח של Ad Manager API קוראות פרטי כניסה מ-Application Default Credentials. אפשר להגדיר אותם באמצעות משתני סביבה או באמצעות 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

מידע נוסף על בחירת סוגי פרטי כניסה ועל יצירה של פרטי כניסה זמין במדריך האימות.

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

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

‎.NET

מתקינים את ספריית הלקוח מ-NuGet.

מ-CLI של ‎.NET:

dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01

כחבילת עזר:

<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />

שליחת הבקשה הראשונה

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. מידע נוסף על ספריות לקוח זמין במדריך ל-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="name_value",
    )

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

    # Handle the response
    print(response)

דוגמאות נוספות זמינות ב-GitHub. מידע נוסף על ספריות לקוח זמין במדריך ל-Python.

‎.NET

    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.

cURL

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