نقل البيانات من الإصدار 1 إلى الإصدار 2

تاريخ آخر تعديل: 2022-12-06

نقل بيانات تطبيقك

لنقل البيانات من الإصدار 1 إلى الإصدار 2، يجب تعديل عناوين URL لنقاط النهاية لطلب الإصدار 2 تحديث تطبيقك لمراعاة التغييرات التي قد تؤدي إلى أعطال.

تعديل "طلبات البيانات من واجهة برمجة التطبيقات" من الإصدار 1 إلى 2

لاستخدام الإصدار 2 بدلاً من الإصدار 1، يجب تعديل طلباتك لاستخدام الإصدار 2 الجديد. والنقاط النهائية.

على سبيل المثال، لاستدعاء طريقة advertisers.get مع الإصدار 1، يمكنك استخدِم عنوان URL التالي:

GET https://displayvideo.googleapis.com/v1/advertisers/advertiserId

بالنسبة إلى الإصدار 2، عدِّل عنوان URL ليصبح ما يلي:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

إذا كنت تستخدم مكتبة برامج لتقديم طلبات إلى واجهة برمجة التطبيقات، استخدِم أحدث إصدار من مكتبة البرامج وحدِّث الإعدادات لاستخدام الإصدار 2.

إجراء التغييرات المطلوبة

سنُجري عددًا من التغييرات التي قد تؤدي إلى أعطال في الإصدار 2. راجِع ما يلي: من التعليمات وإجراء التغييرات المطلوبة ذات الصلة باستخدامك الحالي العرض Video 360 API:

تعديل المكالمات إلى طرق الاستهداف

تعديل المكالمات إلى خدمة "advertisers.lineItems"

  • تمت إزالة الحقل inventorySourceIds. إدارة تعيين مصدر المستودع باستخدام موارد AssignedTargetingOption من TARGETING_TYPE_INVENTORY_SOURCE.

  • تحتوي قيم تعداد LineItemWarningMessage التالية على متوقفة نهائيًا في الإصدار 2 ولن يتم عرضها في LineItem.warningMessages:

    • NO_POSITIVE_AUDIENCE_LIST_TARGETED
    • APP_INSTALL_NO_CONVERSION_PIXEL
    • TARGETING_REVOKED_OR_CLOSED_USER_LIST
    • APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
    • CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
    • NO_CREATIVE_FOR_TARGETED_DEALS
    • TARGETING_DEPRECATED_GEO_TARGET

  • تمت إزالة الحقل triggerId من الكائن LineItemFlight والعنصر تمت إزالة قيمة LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER من نوع التعداد LineItemFlightDateType. لا يتوافق الإصدار 2 مع ضبط تفاصيل الإنفاق استنادًا إلى تفعيل عوامل التشغيل اليدوية.

تعديل المكالمات إلى خدمة "customBiddingAlgorithms"

customBiddingAlgorithmState وmodelReadiness تم استبدال الحقول بـ modelDetails ، الذي يوفّر الاستعداد والتعليق للخوارزمية الحالية لكل معلن لديه حق الوصول من خلال قائمة من CustomBiddingModelDetails الكائنات.

تغييرات إضافية

بالإضافة إلى التغييرات التي قد تؤدي إلى أعطال واردة أعلاه، يقدّم الإصدار 2 أيضًا ميزات جديدة الجديدة.

يمكن العثور على الميزات التي تمّت إضافتها إلى الإصدار 2 بعد الإطلاق الأولي في ملاحظات الإصدار.

إذن بالقراءة فقط في عناصر YouTube

في الإصدار 2، يمكن استرداد عناصر YouTube وإعدادات الاستهداف الخاصة بها باستخدام advertisers.lineItems advertisers.lineItems.targetingTypes.assignedTargetingOptions على التوالي. توفّر واجهة برمجة التطبيقات إذن الوصول للقراءة فقط، أي أنّ وستؤدي طلبات الكتابة التي تمت محاولة إجرائها إلى هذه البنود إلى عرض خطأ. YouTube سيكون العنصر واحدًا مما يلي LineItemType القيم التالية:

طرق جديدة لتحقيق أداء أفضل

في الإصدار الثاني، توفر خدمة advertisers.lineItems ميزات بدلاً من الطلبات المجمّعة لتقديم نتائج أفضل الأداء وتقليل استهلاك الحصة:

إذن وصول جزئي للكتابة من أجل استهداف طلب الإدراج

في الإصدار 2، يمكنك تعديل إعدادات استهداف فرعية لمجموعة فرعية من InsertionOrder الموارد باستخدام create طرق delete في advertisers.insertionOrders.targetingTypes.assignedTargetingOptions خدمة ما. يمكن إدارة أنواع الاستهداف التالية بالكامل عند الإدراج مستوى الطلب:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_BROWSER
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_CHANNEL
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
  • TARGETING_TYPE_OPERATING_SYSTEM
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIEWABILITY