سير عمل واجهة برمجة التطبيقات

يوضّح هذا الدليل إجراءات سير العمل الشائعة لواجهة برمجة التطبيقات من أجل إنشاء الناشرين واستردادهم وتعديلهم في "مساحة العرض والفيديو 360".

الحصول على قائمة بالناشرين

استدعِ LIST API.

إنشاء ناشر جديد

  1. externalPublisherId مطلوب ويجب أن يكون فريدًا. externalPublisherIds يمكن ملؤها بمعرفات الناشر الإضافية.
  2. استدعاء Create API سيتمّ تعيين اسم فريد، ويمكن استخدامه للحصول على "الناشر" الذي تمّ إنشاؤه.
  3. استخدِم طريقة العرض Get API للاطّلاع على تفاصيل الناشر الذي تم إنشاؤه.
  4. اختياريًا، يمكنك تحميل شعار للناشر الذي تم إنشاؤه.

تحديث الناشر

  1. إذا لم تخزِّن اسم الناشر الذي تم إنشاؤه، استخدِم واجهة برمجة التطبيقات LIST للعثور على الناشر الذي تريد تعديله.
  2. عدِّل الحقول استنادًا إلى النتائج من LIST API.
  3. استدعِ Patch API لتعديل الناشر. يجب إدخال updateMask. تشير هذه السمة إلى الحقول التي تريد تطبيق التعديل عليها. لا يمكن ضبط سوى الحقول المسموح بتعديلها في updateMask.

الحقول المهمة التي يجب تقديمها:

  • الاسم المعروض
  • الوصف
  • معلومات الاتصال
  • Logo
  • التوقعات
    • توفير DOMAIN_NAME الذي يملكه الناشر ضمن "التفاصيل"
    • توفير تطبيق يملكه الناشر ضمن appsBreakdown