البدء

استخدِم واجهة برمجة تطبيقات REST في "مدير إعلانات Google" لقراءة بيانات "مدير الإعلانات" وتشغيل التقارير.

لمساعدتك في البدء، نقدم مكتبة برامج لـ Java تحتوي على المزيد من قريبًا. لتقديم طلب البيانات الأول من واجهة برمجة التطبيقات، اتّبِع الخطوات التالية.

الوصول إلى شبكة "مدير الإعلانات"

إذا لم يكن لديك واحد بالفعل، الاشتراك في "مدير الإعلانات" الحساب.

تفعيل واجهة برمجة تطبيقات "مدير الإعلانات"

تفعيل واجهة برمجة تطبيقات "مدير الإعلانات" في مشروع وحدة التحكم في واجهة Google API.

مصادقة

يجب المصادقة على جميع طلبات البيانات من واجهة برمجة التطبيقات باستخدام OAuth2.

يمكن لمكتبات عملاء واجهة برمجة تطبيقات مدير الإعلانات REST قراءة بيانات الاعتماد من بيانات الاعتماد التلقائية للتطبيق. لضبط هذه باستخدام متغيرات البيئة أو 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