البدء

استخدِم Google Ad Manager API (الإصدار التجريبي) لقراءة بيانات "مدير إعلانات Google" وعرض التقارير.

لإجراء طلبك الأول من خلال واجهة برمجة التطبيقات، أكمِل الخطوات التالية:

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

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

تفعيل Ad Manager API

فعِّل واجهة برمجة التطبيقات Ad Manager API في مشروعك على Google API Console.

مصادقة

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

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

من سطر أوامر .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);
    }
  }
}
SyncGetNetwork.java

يمكنك العثور على المزيد من الأمثلة على 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)
admanager_v1_generated_network_service_get_network_sync.py

يمكنك العثور على المزيد من الأمثلة على 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);
        }
    }
NetworkServiceClient.GetNetworkSnippet.g.cs

يمكنك العثور على المزيد من الأمثلة على GitHub. للحصول على معلومات إضافية عن مكتبة البرامج، يُرجى الاطّلاع على دليل ‎.NET.

cURL 

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