إعداد واجهة برمجة التطبيقات لإعداد تقارير Exchange وإعداد بروتوكول "مساحة العرض والفيديو 360"

توفّر واجهة برمجة التطبيقات DV360 Exchange Reporting API لشركاء Third-Party Exchange (3PE) إمكانية الوصول الآلي إلى تقارير الأداء من "مساحة العرض والفيديو 360".

يتم عرض واجهة برمجة التطبيقات DV360 Exchange Reporting API كواجهة Google Cloud API مستندة إلى قائمة السماح وتستخدم بروتوكول OAuth. يتولّى فريق واجهة برمجة التطبيقات الخاصة بتقارير "مساحة العرض والفيديو 360" عملية الإدراج في القائمة المسموح بها.

الإجراء

في ما يلي خطوات إعداد واجهة برمجة التطبيقات Exchange Reporting API في "مساحة العرض والفيديو 360":

  1. اشترِك في حساب Google على وحدة تحكّم Google Cloud.

    يُرجى العِلم أنّه يجب استخدام هذا الحساب لإدارة رموز الدخول المميزة الخاصة بعميلك المباشر، لذا لا تستخدم حسابك الشخصي على Gmail.

  2. يُرجى التواصل مع فريق "مساحة العرض والفيديو 360" في Google وتقديم معلومات الحساب لإضافته إلى القائمة المسموح بها.

  3. بعد تلقّي إشعار بأنّك أُضفت إلى قائمة السماح، يمكنك طلب إجراء مراجعة للتحقّق من صحة OAuth لمنح تطبيقك إذن الوصول إلى نطاق doubleclickbidmanager.

  4. سجِّل الدخول إلى Google Cloud Console.

    انتقِل إلى واجهات برمجة التطبيقات والخدمات > المكتبة > خاص. من المفترض أن تظهر لك واجهة برمجة التطبيقات Exchange Reporting API في "مساحة العرض والفيديو 360" ضمن قائمة واجهات برمجة التطبيقات المتاحة لك. فعِّل واجهة برمجة التطبيقات DV360 Exchange Reporting API.

  5. انتقِل إلى بيانات الاعتماد > إنشاء بيانات اعتماد > مفتاح حساب الخدمة. اتّبِع التعليمات لإنشاء حساب خدمة.

حساب الخدمة

يتيح حساب الخدمة لرمزك البرمجي إرسال بيانات اعتماد التطبيق مباشرةً إلى واجهة برمجة التطبيقات. يتم تمثيل حساب الخدمة، مثل حساب المستخدم، بعنوان بريد إلكتروني. على عكس حساب المستخدم، ينتمي حساب الخدمة إلى تطبيق فقط، ولا يمكن استخدامه إلا للوصول إلى واجهة برمجة التطبيقات التي تم إنشاؤه من أجلها.

في ما يلي خطوات إنشاء بيانات اعتماد حساب الخدمة باستخدام Google Cloud Console:

  1. من صفحة إدارة واجهات برمجة التطبيقات > بيانات الاعتماد، اختَر إنشاء بيانات اعتماد > مفتاح حساب الخدمة.

  2. اختَر حساب خدمة جديد من القائمة المنسدلة حساب الخدمة.

    أدخِل اسمًا لحساب الخدمة هذا. يُستخدَم هذا الاسم كاسم تلقائي لمعرّف حساب الخدمة، على يمين @ في عنوان معرّف حساب الخدمة الذي تم إنشاؤه.

    ضمن نوع المفتاح، ننصحك بترك هذه القيمة على JSON. انقر على إنشاء لإنشاء مفتاح JSON كملف نصي .json. عندما يُطلب منك ذلك، نزِّل الملف على جهاز الكمبيوتر وسيظهر مربع الحوار تم إنشاء حساب خدمة.

    في ما يلي نموذج لمفتاح JSON:

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. يجب تخزين ملف JSON بشكل آمن، لأنّه يحتوي على مفتاحك الخاص، وهذا الملف هو النسخة الوحيدة من هذا المفتاح. يجب توفّر بيانات الاعتماد في هذا الملف عندما يطلب الرمز البرمجي واجهة برمجة التطبيقات.

  4. تواصَل مع فريق "مساحة العرض والفيديو 360" وقدِّم معلومات حساب الخدمة الذي أنشأته، وتحديدًا عنوان البريد الإلكتروني لحساب الخدمة، وذلك كجزء من عملية إضافة حسابك إلى القائمة المسموح بها للوصول إلى واجهة برمجة التطبيقات.

رمز الدخول

بعد منح حساب الخدمة الإذن بإجراء طلبات إلى واجهة برمجة التطبيقات، يمكنك المتابعة مع الأمثلة الواردة في أدلة واجهة برمجة التطبيقات. للحصول على رمز مميز للوصول يدويًا، يمكنك استخدام أداة مثل oauth2l أو استخدام إحدى مكتبات البرامج الخاصة بنا للمصادقة آليًا.