שימוש ב-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