البدء

‫Display & Video 360 API هي الواجهة الآلية لمنصّة "مساحة العرض والفيديو 360". يمكنك استخدام Display & Video 360 API لأتمتة سير العمل المعقدة في "مساحة العرض والفيديو 360". في ما يلي بعض الأمثلة على المهام التي يمكنك تنفيذها باستخدام واجهة برمجة التطبيقات Display & Video 360 API:

يوضّح هذا الدليل كيفية بدء استخدام Display & Video 360 API.

المتطلبات الأساسية

قبل استخدام واجهة برمجة التطبيقات Display & Video 360 API، عليك إجراء ما يلي:

  1. يجب أن يكون لديك حساب على Google. تحتاج إلى حساب Google من أجل إنشاء مشروع في وحدة تحكّم واجهة برمجة التطبيقات Google API Console. إذا كان لديك حساب، يمكنك استخدامه. قد تحتاج أيضًا إلى حساب Google منفصل لأغراض testing.

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

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

اختيار مشروع

عليك إنشاء أو اختيار مشروع في وحدة تحكّم واجهة برمجة تطبيقات Google وتفعيل واجهة برمجة التطبيقات.

يمكنك إنشاء مشروع جديد أو استخدام مشروع حالي.

إنشاء مشروع جديد

اتّبِع الخطوات الواردة في Google API Console لإنشاء مشروع وتفعيل واجهة برمجة التطبيقات Display & Video 360 API تلقائيًا.

استخدام مشروع حالي

في ما يلي كيفية تفعيل Display & Video 360 API يدويًا لمشروع حالي.

لتفعيل واجهة برمجة تطبيقات لمشروعك، اتّبِع الخطوات التالية:

  1. افتح "مكتبة واجهات برمجة التطبيقات" في "وحدة تحكّم واجهة Google API". اختَر مشروعًا أو أنشئ مشروعًا جديدًا إذا طُلب منك ذلك. تعرض "مكتبة واجهات برمجة التطبيقات" كلّ واجهات برمجة التطبيقات المتاحة، مجمّعة حسب عائلة المنتجات ومدى رواج استخدامها.
  2. إذا لم تظهر واجهة برمجة التطبيقات التي تريد تفعيلها في القائمة، استخدِم ميزة البحث للعثور عليها.
  3. اختَر واجهة برمجة التطبيقات التي تريد تفعيلها، ثم انقر على الزر تفعيل.
  4. فعِّل ميزة الفوترة إذا طُلب منك ذلك.
  5. اقبل بنود خدمة واجهة برمجة التطبيقات إذا طُلب منك ذلك.

إنشاء بيانات الاعتماد

يجب أن تكون جميع الطلبات التي تقدّمها إلى واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" مصرّحًا بها. للحصول على نظرة عامةمختصرة على التفويض، يُرجى الاطّلاع على كيفية تفويض Google بالوصول إلى تطبيقك وتحديد هويته.

سترشدك التعليمات التالية خلال عملية إنشاء معرّف مستخدم OAuth 2.0 لاستخدامه مع مسار التطبيق المثبّت. للحصول على تعليمات حول إنشاء بيانات الاعتماد لاستخدامها مع مسار حساب الخدمة، يُرجى الرجوع إلى دليل حسابات الخدمة.

  1. اتّبِع الخطوات اللازمة لضبط مشروع على Google API Console.

  2. افتح صفحة بيانات الاعتماد في وحدة تحكّم واجهة برمجة التطبيقات.

  3. انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.

  4. اختَر نوع التطبيق الأكثر ملاءمةً عندما يُطلب منك ذلك. تستند مقتطفات الرموز البرمجية لـ Java و Python المقدَّمة في هذه الأدلة إلى تطبيق كمبيوتر مكتبي، في حين تستند مقتطفات الرموز البرمجية لـ PHP إلى تطبيق ويب.

  5. أدخِل أي معلومات إضافية مطلوبة.

    • إذا كانت هذه هي المرة الأولى التي تنشئ فيها معرّف عملاء، بالإضافة إلى التمكّن من اختيار نوع تطبيقك، يمكنك ضبط شاشة الموافقة من خلال النقر على الزر ضبط شاشة الموافقة. لن تظهر لك رسالة تطلب منك ضبط شاشة طلب الموافقة مرة أخرى بعد ضبطها في المرة الأولى، ولكن يمكن تعديل هذه المعلومات في أي وقت.

  6. انقر على إنشاء.

عند الانتهاء، سيظهر لك معرّف عميل وملف تعريف العميل لبروتوكول OAuth 2.0، ويمكنك تنزيلهما بتنسيق JSON وحفظهما لاستخدامهما لاحقًا.

عند استخدام بروتوكول OAuth 2.0 للمصادقة، تتم مصادقة المستخدمين بعد أن يوافقوا على الأحكام التي يتم عرضها لهم على شاشة طلب موافقة المستخدم.

لإعداد شاشة الموافقة لمشروعك، اتّبِع الخطوات التالية:

  1. افتح صفحة شاشة الموافقة في "وحدة تحكّم واجهة برمجة التطبيقات من Google". اختَر مشروعًا أو أنشئ مشروعًا جديدًا إذا طُلب منك ذلك.
  2. املأ النموذج وانقر على حفظ.
التالي
تثبيت مكتبات العملاء