"مساحة العرض والفيديو 360 API" هي الواجهة الآلية لمنصة "مساحة العرض والفيديو 360". يمكنك استخدام "مساحة العرض والفيديو 360 API" لتنفيذ سير العمل المعقد في "مساحة العرض والفيديو 360" بشكل مبرمَج. في ما يلي بعض الأمثلة على المهام التي يمكنك تنفيذها باستخدام "مساحة العرض والفيديو 360 API":
- تحميل المواد الإبداعية وإنشاؤها
- إدارة تفاصيل الإعلان واستهدافها
- إنشاء ملفات البيانات المنظَّمة وتنزيلها:
يوضِّح هذا الدليل كيفية بدء استخدام مساحة العرض والفيديو 360 API.
المتطلبات الأساسية
قبل استخدام "مساحة العرض والفيديو 360 API"، عليك إجراء ما يلي:
يجب أن يكون لديك حساب على Google. تحتاج إلى حساب Google من أجل إنشاء مشروع في وحدة تحكم واجهة برمجة تطبيقات Google. إذا كان لديك حساب، فأنت جاهز تمامًا. قد ترغب أيضًا في حساب Google منفصل لأغراض الاختبار.
يجب أن يكون لديك إذن الوصول إلى "مساحة العرض والفيديو 360". يجب أن يكون لديك إذن بالوصول إلى منتج "مساحة العرض والفيديو 360" لتتمكّن من استخدام واجهة برمجة التطبيقات. إذا سبق أن تم إبرام عقد مع مؤسستك في "مساحة العرض والفيديو 360"، تأكَّد من إنشاء ملف شخصي للمستخدم بالأذونات المناسبة لحساباتك على Google. وإذا لم يكن الأمر كذلك، يُرجى التواصل مع فريق المبيعات للحصول على مزيد من المعلومات.
ننصحك بتجربة "مساحة العرض والفيديو 360". تفترض مستندات واجهة برمجة التطبيقات هذه أنّك استخدمت "مساحة العرض والفيديو 360"، وأنّك على دراية بمفاهيم برمجة الويب وتنسيقات بيانات الويب. إذا لم تكن قد استخدمت "مساحة العرض والفيديو 360 "، جرِّب واجهة مستخدم الويب قبل البدء في الترميز.
اختيار مشروع
يجب إنشاء مشروع أو اختياره في وحدة التحكم في واجهة Google API وتفعيل واجهة برمجة التطبيقات
ويمكنك إنشاء مشروع جديد أو استخدام مشروع حالي.
خطوات إنشاء مشروع جديد
اتّبِع الخطوات الواردة في وحدة التحكم في واجهة Google API لإنشاء مشروع وتفعيل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" تلقائيًا.
استخدام مشروع حالي
في ما يلي كيفية تفعيل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360 " يدويًا لمشروع حالي.
لتمكين واجهة برمجة تطبيقات لمشروعك، قم بما يلي:
- افتح مكتبة واجهة برمجة التطبيقات في وحدة تحكم واجهة برمجة تطبيقات Google. اختَر مشروعًا أو أنشئ مشروعًا جديدًا إذا طُلب منك ذلك. تسرد مكتبة واجهة برمجة التطبيقات جميع واجهات برمجة التطبيقات المتاحة، مجمّعة حسب مجموعة المنتجات ومدى الرواج.
- إذا كانت واجهة برمجة التطبيقات التي تريد تفعيلها غير مرئية في القائمة، يمكنك استخدام ميزة البحث للعثور عليها.
- اختر واجهة برمجة التطبيقات التي تريد تفعيلها، ثم انقر على الزر تفعيل.
- فعِّل الفوترة إذا طُلب منك ذلك.
- يجب قبول بنود خدمة واجهة برمجة التطبيقات إذا طُلب منك ذلك.
إنشاء بيانات اعتماد
يجب أن يتم تفويض جميع الطلبات التي يتم تقديمها إلى "مساحة العرض والفيديو 360 API". للحصول على نظرة عامة مختصرة على التفويض، يمكنك الاطّلاع على كيفية تفويض تطبيقك وتعريفه على Google.
ترشدك التعليمات التالية خلال عملية إنشاء معرِّف عميل OAuth 2.0 لاستخدامه مع مسار التطبيقات المثبّتة. للحصول على تعليمات حول إنشاء بيانات الاعتماد لاستخدامها مع تدفق حساب الخدمة، يُرجى الاطِّلاع على دليل حسابات الخدمة.
اتّبِع الخطوات لإعداد مشروع وحدة تحكّم واجهة برمجة تطبيقات Google.
- افتح صفحة بيانات الاعتماد في وحدة تحكُّم واجهة برمجة التطبيقات.
انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
اختَر نوع التطبيق الأكثر ملاءمة عندما يُطلب منك ذلك. تفترض مقتطفات الرموز البرمجية بلغة Java وPython المعروضة في هذه الأدلة أنّها تطبيق متوافق مع أجهزة الكمبيوتر المكتبي، بينما تفترض مقتطفات رمز PHP أنّ هناك تطبيق ويب.
أدخِل أي معلومات إضافية مطلوبة.
- إذا كانت هذه هي المرة الأولى التي تُنشئ فيها معرِّف عميل، بالإضافة إلى إمكانية اختيار نوع التطبيق، يمكنك ضبط شاشة الموافقة من خلال النقر على الزر إعداد شاشة الموافقة. لن تتلقّى مطالبة بإعداد شاشة الموافقة مرة أخرى بعد استخدامها في المرة الأولى، ولكن يمكن تعديل هذه المعلومات في أي وقت.
انقر على إنشاء.
عند الانتهاء، سيظهر لك معرِّف عميل OAuth 2.0 وسر العميل اللذين يمكنك تنزيلهما بتنسيق JSON وحفظهما لاستخدامه لاحقًا.
ضبط شاشة موافقة المستخدم
عند استخدام OAuth 2.0 للمصادقة، تتم مصادقة المستخدمين بعد موافقتهم على البنود المقدَّمة لهم على شاشة موافقة المستخدم.
لإعداد شاشة طلب الموافقة في مشروعك، نفِّذ ما يلي:
- افتح صفحة "شاشة الموافقة" في وحدة تحكُّم Google API. اختَر مشروعًا أو أنشئ مشروعًا جديدًا عندما يُطلب منك ذلك.
- املأ النموذج وانقر على حفظ.