ملاحظات الإصدار

تعرض هذه الصفحة ملاحظات إصدار واجهة برمجة التطبيقات "مساحة العرض والفيديو 360".

أحدث إصدار من واجهة برمجة التطبيقات: الإصدار 3

23 نيسان (أبريل) 2024

الميزات الجديدة

تمت إضافة دعم لأنواع مؤشرات الأداء الرئيسية الجديدة وعمليات التبادل والأنظمة الأساسية للتطبيقات.

v3

• تمت إضافة الحقول التالية:

  المورد	الحقول
  مؤشر الأداء الرئيسي	kpiAlgorithmId

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	EXCHANGE_DRAX
  KpiType	KPI_TYPE_CPCL KPI_TYPE_CPCV KPI_TYPE_CPV KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST KPI_TYPE_MAXIMIZE_PACING KPI_TYPE_TOS10
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

‫28 فبراير 2024

الميزات الجديدة

تمت إضافة إمكانية إزالة الأعضاء صراحةً من شرائح جمهور مطابقة العملاء.

تم توفير دعم لاستهداف عمليات تبادل جديدة.

v3

• تمت إضافة الحقول التالية:

  المورد	الحقول
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

• تمت إضافة الحقول التالية:

  المورد	الحقول
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

29 كانون الثاني (يناير) 2024

الميزات الجديدة

تمت إضافة إمكانية استرداد أنشطة Floodlight من خلال خدمة floodlightGroups.floodlightActivities جديدة.

تمت إضافة حقل جديد يوضّح ما إذا كان عنصر YouTube والشركاء يتضمّن مستودع Google TV في استهدافه.

تمت إضافة حقل جديد لإرسال وقت آخر تسجيل دخول لمستخدم "مساحة العرض والفيديو 360".

v3

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  floodlightGroups.floodlightActivities	الحصول على list

• تمت إضافة الحقول التالية:

  المورد	الحقول
  المستخدم	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  floodlightGroups.floodlightActivities	الحصول على list

• تمت إضافة الحقول التالية:

  المورد	الحقول
  المستخدم	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

‏14 تشرين الثاني (نوفمبر) 2023

الميزات الجديدة

تمت إضافة الدعم اللازم لتمرير موافقة المستخدم عند تحميل أعضاء جمهور "مطابقة العملاء" في جميع النُسخ المباشرة.

v3

• تمت إضافة الحقول التالية:

  المورد	الحقول
  ContactInfoList	الموافقة
  MobileDeviceIdList	الموافقة

v2

• تمت إضافة الحقول التالية:

  المورد	الحقول
  ContactInfoList	الموافقة
  MobileDeviceIdList	الموافقة

31 تشرين الأول (أكتوبر) 2023

الميزات الجديدة

تم نقل الإصدار 3 من إصدار تجريبي علني إلى مرحلة التوفّر للجمهور العام.

تمت إعادة تسمية قيمة التعداد AdGroupFormat في الإصدار 3 لكي تعكس التنسيق ذي الصلة بشكل أكثر دقة.

تمت إتاحة الإصدار السابع من ملفات البيانات المنظَّمة مع إضافة قيمة التعداد SDF_VERSION_7 في الإصدارَين 2 و3.

v3

• تمت إزالة قيم التعداد التالية:

  التعداد	القيم
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  SdfVersion	SDF_VERSION_7

‫2 تشرين الأول (أكتوبر) 2023

الميزات الجديدة

تم إطلاق الإصدار 3 من إصدار تجريبي متاح للجميع، والذي يتضمن التغييرات التالية:

• إمكانية إدارة قوائم المواقع الجغرافية القريبة بشكل كامل، ما يتيح استخدام خدمة advertisers.locationLists.assignedLocations لإنشاء وحذف المواقع الجغرافية التي تم تعيينها إلى موارد TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• حقل enableOptimizedTargeting منطقي جديد يحل محل الحقل targetingExpansionLevel في العنصر TargetingExpansionConfig
• متطلبات الحقل billingConfig في المورد Advertiser، والذي يجب تضمينه عند إرسال طلبات advertisers.create، وحقل billingConfig جديد في المورد Partner.
• موارد AdGroup وAdGroupAd جديدة تستبدل موارد YoutubeAdGroup وYoutubeAdGroupAd في الإصدار 2.

اتّبِع الخطوات الواردة في دليل نقل البيانات للانتقال من الإصدار v2 إلى الإصدار 3.

تمت إضافة معلومات عن 3 قيم جديدة في LineItemType وقيمة جديدة للسمة YoutubeAndPartnersBiddingStrategyType وسمة جديدة PartnerCostType في الإصدارَين 2 و3.

v3

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  advertisers.adGroupAds	الحصول على list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions الحصول على list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	الحصول على list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	إنشاء الحصول على list

• لقد تمت إزالة الطرق التالية:

  الخدمة	الطُرق
  advertisers.manualTriggers	تفعيل إنشاء إلغاء تفعيل الحصول على قائمة رمز تصحيح
  advertisers.youtubeAdGroupAds	الحصول على قائمة
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions الحصول على قائمة
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	الحصول على قائمة

• تم تغيير سلوك الطريقة التالية:

  الطريقة	التغييرات
  advertisers.locationLists.create	يتيح الآن إنشاء موارد LocationList لبرامج TARGETING_LOCATION_TYPE_PROXIMITY.
  advertisers.locationLists.patch	يتيح الآن تحديث موارد LocationList لبرامج TARGETING_LOCATION_TYPE_PROXIMITY.
  advertisers.locationLists.assignedLocations.bulkEdit	يتيح الآن التعديل المجمَّع لموارد AssignedLocation في TARGETING_LOCATION_TYPE_PROXIMITY موارد LocationList.
  advertisers.locationLists.assignedLocations.create	يتيح الآن إنشاء موارد AssignedLocation في موارد TARGETING_LOCATION_TYPE_PROXIMITY LocationList.

• تمت إضافة مَعلمات طلب البحث التالية:

  الطريقة	المَعلمات
  inventorySources.get	advertiserId

• أصبحت الحقول التالية مطلوبة:

  المورد	الحقول
  المعلِن	billingConfig

• تمت إضافة الحقول التالية:

  المورد	الحقول
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	مؤشر الأداء الرئيسي
  شريك	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• لقد تمت إزالة الحقول التالية:

  المورد	الحقول
  InsertionOrder	performanceGoal billableOutcome
  TargetingExpansionConfig	excludeFirstPartyAudience targetingExpansionLevel
  YoutubeAndPartnersSettings	biddingStrategy thirdPartyMeasurementSettings
  YoutubeAndPartnersInventorySourceConfig	includeYoutubeSearch includeYoutubeVideos

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  CustomBiddingAlgorithmType	RULE_BASED
  LineItemType	LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
  PartnerCostType	PARTNER_COST_TYPE_SCIBIDS_FEE
  ReadinessState	READINESS_STATE_EVALUATION_FAILURE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

• تمت إزالة قيم التعداد التالية:

  التعداد	القيم
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  LineItemType	LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
  PartnerCostType	PARTNER_COST_TYPE_SCIBIDS_FEE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

25 آب (أغسطس) 2023

الميزات الجديدة

تمت إضافة الدعم إلى نوعَين جديدَين من عمليات التبادل ونوعَين جديدَين من استراتيجيات عروض الأسعار في YouTube والشركاء.

تمت إضافة حقل effectiveContentCategory جديد إلى عناصر YouTube و"الشركاء" لعرض YoutubeAndPartnersContentCategory التي يستخدمها العنصر عند مراعاة القيم المخصّصة على مستوى كلٍّ من المعلِن والعنصر.

v2

• تمت إضافة الحقول التالية:

  المورد	الحقول
  YoutubeAndPartnersSettings	effectiveContentCategory

• لقد تمت إزالة الحقول التالية:

  المورد	الحقول
  InventorySource	subSitePropertyId

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  Exchange	EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

‫5 حزيران (يونيو) 2023

الميزات الجديدة

تمت إضافة قيمة جديدة من أجل SdfVersion لملفات البيانات المنظَّمة (SDF) v6 في الإصدارَين 1 و2.

v2

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  SdfVersion	SDF_VERSION_6

v1

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  SdfVersion	SDF_VERSION_6

9 آذار (مارس) 2023

الميزات الجديدة

تمت إضافة قيمة LineItemWarningMessage جديدة سيتم تخصيصها للحقل warningMessages في أحد العناصر في حال ضبط حقل excludeFirstPartyAudience المتوقّف نهائيًا على true. سيتم إيقاف الحقل excludeFirstPartyAudience نهائيًا وضبطه على false بعد 25 آذار (مارس) 2023.

v2

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 شباط (فبراير) 2023

الميزات الجديدة

تمت إضافة إمكانية استرداد موارد YouTubeAdGroup وYouTubeAdGroupAd، فضلاً عن استهداف الموارد في المجموعة الإعلانية على YouTube. بالإضافة إلى ذلك، أضفنا أيضًا أنواع استهداف جديدة يمكن استردادها ويتم استخدامها على مستوى المجموعات الإعلانية على YouTube. لمزيد من المعلومات، يُرجى قراءة صفحة الدليل الجديدة حول استرداد موارد YouTube والشركاء.

تمت إضافة دعم لأربعة عمليات تبادل إضافية في الإصدارين الأول والثاني.

v2

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  advertisers.youtubeAdGroupAds	الحصول على list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions الحصول على list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	الحصول على list

• تمت إضافة الحقول التالية:

  الخدمة	الطُرق
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
  TargetingType	TARGETING_TYPE_SESSION_POSITION TARGETING_TYPE_YOUTUBE_CHANNEL TARGETING_TYPE_YOUTUBE_VIDEO

v1

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

6 كانون الأول (ديسمبر) 2022

الميزات الجديدة

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

تمت إضافة حقل assignedTargetingOptionIdAlias جديد إلى المورد AssignedTargetingOption، الذي يمكن استخدامه بدلاً من assignedTargetingOptionId عند استرداد الاستهداف وحذفه. يتم تعيين هذا الحقل فقط لخيارات الاستهداف المعينة لأنواع الاستهداف التي تم تعيينها عبر التعداد. قيمة الاسم المستعار هي قيمة التعداد ذات الصلة كسلسلة.

تمت إضافة حقل billingConfig جديد إلى مورد Advertiser.

تمت إضافة الدعم لاسترداد عناصر خدمة YouTube & Partners غير المباشرة، التي تم تحديدها من خلال ثلاث قيم جديدة في LineItemType.

تم زيادة الحد الأقصى لحجم الصفحة إلى 200 للعديد من طرق list في الإصدارين 1 و2. ولن يتغيّر حجم الصفحة التلقائي.

v2

• تمت إضافة الحقول التالية:

  المورد	الحقول
  المعلِن	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

• تمت زيادة الحد الأقصى لحجم الصفحة في طرق القوائم التالية:

  الطريقة	الحد الأقصى الجديد لحجم الصفحة
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

v1

• تمت زيادة الحد الأقصى لحجم الصفحة في طرق القوائم التالية:

  الطريقة	الحد الأقصى الجديد لحجم الصفحة
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

المشاكل المعروفة

يُصلح هذا التحديث المشاكل المعروفة التالية في الإصدار 2:

• تعذّرت إزالة أو استرداد خيارات الاستهداف المعيَّنة لأنواع الاستهداف المحدَّدة باستخدام قيم التعداد في الإصدار 2 باستخدام assignedTargetingOptionId، وبدلاً من ذلك توقع من المستخدمين استخدام قيمة التعداد. من خلال هذا التعديل، يمكن إزالة أو استرداد خيارات الاستهداف المحدّدة باستخدام assignedTargetingOptionId أو قيمة التعداد التي يحدّدها الحقل assignedTargetingOptionIdAlias الجديد في المورد AssignedTargetingOption.
• لم يكن طلب العنصر bulkUpdate يستخدم معلَمة طلب advertisersId بشكلٍ صحيح، ما أدّى إلى عرض خطأ. وبفضل هذا التعديل، تم إصلاح الطريقة وتغيير اسم معلَمة الطلب من advertisersId إلى advertiserId.

27 تشرين الأول (أكتوبر) 2022

تمت إضافة إمكانية تكرار عنصر حالي ضمن العنصر الرئيسي InsertionOrder.

تم توفير ميزة استهداف طلب الإدراج الجزئي لإتاحة الكتابة لمجموعة فرعية من أنواع الاستهداف مع إضافة طريقتَي create وdelete إلى خدمة advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

الميزات الجديدة

v2

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	إنشاء حذف
  advertisers.lineItems	نسخة طبق الأصل

v1

لم تتم إضافة ميزات جديدة إلى الإصدار 1.

20 أيلول (سبتمبر) 2022

تم إطلاق الإصدار 2 في إصدار تجريبي متاح للجميع، والذي يتضمّن التغييرات التالية:

• إمكانية استرداد عناصر YouTube والشركاء وإعدادات الاستهداف الخاصة بها باستخدام طريقتَي get وlist في خدمتَي advertisers.lineItems وadvertisers.lineItems.targetingTypes.assignedTargetingOptions .
• طريقتان جديدتان للاستهداف المجمَّع في خدمة advertisers.lineItems تتيحان إمكانية تعديل واسترداد الاستهداف المحدّد على مستوى عناصر متعدّدة من خلال طلب واحد.
• طريقة bulkUpdate جديدة تسمح للمستخدمين بتعديل entityStatus لعناصر متعددة في طلب واحد.
• منطق استهداف جديد يتطلب تخصيص AssignedTargetingOption موارد من مجموعة فرعية من أنواع الاستهداف واستردادها باستخدام قيم التعداد بدلاً من أرقام تعريف خيارات الاستهداف باستخدام خدمة targetingTypes.targetingOptions.

اتّبِع الخطوات الواردة في دليل نقل البيانات للانتقال من الإصدار 1 إلى الإصدار 2.

تمت إضافة دعم لثلاث عمليات تبادل جديدة في الإصدار 1.

الميزات الجديدة

v2

في ما يلي قائمة بالتغييرات بين الإصدارين 1 و2:

• تمت إضافة الطرق التالية في الإصدار 2:

  الخدمة	الطُرق
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• تمت إزالة الطرق التالية من الإصدار 2:

  الخدمة	الطُرق
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• تمت إعادة تسمية الطرق التالية في الإصدار 2:

  الخدمة	اسم الطريقة القديمة	اسم الطريقة الجديدة
  المعلنون	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• تستخدِم موارد AssignedTargetingOption من أنواع الاستهداف التالية التعدادات لتخصيص الاستهداف في الإصدار 2. تم أيضًا تعديل الحقل assignedTargetingOptionId لمورد AssignedTargetingOption من أنواع الاستهداف هذه في الإصدار 2 لاستخدام إصدارات سلسلة من قيم التعداد:

  نوع الاستهداف	نوع التعداد
  TARGETING_TYPE_AGE_RANGE	AgeRange
  TARGETING_TYPE_CONTENT_INSTREAM_POSITION	ContentInstreamPosition
  TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION	ContentOutstreamPosition
  TARGETING_TYPE_DEVICE_TYPE	DeviceType
  TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION	ContentRatingTier
  TARGETING_TYPE_ENVIRONMENT	البيئة
  TARGETING_TYPE_EXCHANGE	Exchange
  TARGETING_TYPE_GENDER	الجنس
  TARGETING_TYPE_HOUSEHOLD_INCOME	HouseholdIncome
  TARGETING_TYPE_NATIVE_CONTENT_POSITION	NativeContentPosition
  TARGETING_TYPE_OMID	أوميد
  TARGETING_TYPE_PARENTAL_STATUS	ParentalStatus
  TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION	SensitiveCategory
  TARGETING_TYPE_VIDEO_PLAYER_SIZE	VideoPlayerSize
  TARGETING_TYPE_VIEWABILITY	إمكانية العرض

• تمت إضافة الحقول التالية في الإصدار 2:

  المورد	الحقول
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	تبادل
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• تمت إزالة الحقول التالية في الإصدار 2:

  المورد	الحقول
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  CustomBiddingAlgorithm	customBiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRatingTier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  GenderAssignedTargetingOptionDetails	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  LineItem	inventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId sensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

• تم جعل الحقول التالية مطلوبة في الإصدار 2:

  المورد	الحقول
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	البيئة
  ExchangeAssignedTargetingOptionDetails	تبادل
  GenderAssignedTargetingOptionDetails	الجنس
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	إمكانية العرض

• تمت إضافة قيم التعداد التالية في الإصدار 2:

  التعداد	القيم
  AgeRange	AGE_RANGE_18_20 AGE_RANGE_21_24 AGE_RANGE_25_29 AGE_RANGE_30_34 AGE_RANGE_35_39 AGE_RANGE_40_44 AGE_RANGE_45_49 AGE_RANGE_50_54 AGE_RANGE_55_59 AGE_RANGE_60_64
  ContentRatingTier	CONTENT_RATING_TIER_FAMILIES
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
  ReservationType	RESERVATION_TYPE_INSTANT_RESERVE RESERVATION_TYPE_PETRA_VIRAL
  SensitiveCategory	SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

• تمت إزالة قيم التعداد التالية في الإصدار 2:

  التعداد	القيم
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
  LineItemWarningMessage	APP_INSTALL_NO_CONVERSION_PIXEL APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS NO_CREATIVE_FOR_TARGETED_DEALS NO_POSITIVE_AUDIENCE_LIST_TARGETED TARGETING_DEPRECATED_GEO_TARGET TARGETING_REVOKED_OR_CLOSED_USER_LIST

v1

• تمت إضافة قيم التعداد التالية في الإصدار 1:

  التعداد	القيم
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

26 أيار (مايو) 2022

تمت إضافة إمكانية إنشاء موارد InventorySource وإدارة موارد GuaranteedOrder من خلال طرق الكتابة في خدمة inventorySources الجديدة وخدمة guaranteedOrders.

تم إدخال الحقل modelReadiness في المورد CustomBiddingAlgorithm. يسرد هذا الحقل مدى جاهزية نموذج الخوارزمية لكل معلِن يمكنه الوصول إليه.

تم تفعيل وظيفة جديدة لمَعلمة طلب البحث filter لطريقة advertisers.creatives.list التي تسمح للمستخدم باسترداد تصميمات الإعلانات باستخدام updateTime فقط قبل طابع زمني معيّن أو بعده.

تمت إضافة الدعم لأحدث إصدار من SDF، وهو v5.5، من خلال إضافة قيمة تعداد SdfVersion.

الميزات الجديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  guaranteedOrders	إنشاء editGuaranteedOrderReadAccessors الحصول على list تصحيح
  inventorySources	إنشاء editInventorySourceReadWriteAccessors تصحيح

• تمت إضافة الحقول التالية:

  المورد	الحقول
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  SdfVersion	SDF_VERSION_5_5

• يمكن الآن فلترة طرق القوائم التالية حسب السمات التالية:

  الطريقة	الحقول
  advertisers.creatives.list	updateTime

31 آذار (مارس) 2022

تمت إضافة ميزة استرداد الاستهداف وضبطه حسب مدة المحتوى ونوع البث والنوع.

تمت إضافة الحقل billableOutcome إلى الكائن InsertionOrder.

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

الميزات الجديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 شباط (فبراير) 2022

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

تم إدخال حقل reservationType جديد في موارد InsertionOrder وLineItem يحدد ما إذا كان المورد لديه علامة "ضمان العلامة" أو "ضمان آلي" أو غير مضمون.

تمت إضافة إمكانية استرداد وتحديد ما إذا كان العنصر يستهدف تلقائيًا التبادلات الجديدة من خلال حقل excludeNewExchanges جديد.

بالإضافة إلى الميزات الجديدة، تمت مضاعفة حدود الحصص التلقائية.

الميزات الجديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  firstAndThirdPartyAudiences	إنشاء editCustomerMatchMembers تصحيح

• تمت إضافة الحقول التالية:

  المورد	الحقول
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

8 كانون الأول (ديسمبر) 2021

تمت إضافة دعم إلى استهداف نوع المحتوى الصوتي ضمن نوع الاستهداف TARGETING_TYPE_AUDIO_CONTENT_TYPE.

الميزات الجديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8 تشرين الثاني (نوفمبر) 2021

تمت إضافة الدعم الكامل لإدارة خوارزميات عروض الأسعار المخصّصة ونصوصها البرمجية. يشمل ذلك ما يلي:

• دوال لإنشاء جديدة وتعديل الحالية customBiddingAlgorithms.
• إمكانية تحميل النصوص البرمجية من خلال عملية استرداد موقع مورد متاح ثم تحميل الملف إلى ذلك الموقع
• خدمة customBiddingAlgorithms.scripts جديدة لاسترداد البيانات والإنشاء customBiddingScripts.

تمّت إضافة صفحة تنفيذ عروض أسعار مخصّصة جديدة إلى دليل إدارة العناصر الذي يصف عملية إنشاء خوارزمية عروض أسعار مخصّصة، وتحميل نص برمجي، وتعيين خوارزمية عروض الأسعار المخصّصة لتكون استراتيجية عروض الأسعار للعنصر.

تمت إضافة الدعم لأحدث إصدار من SDF، v5.4، من خلال إضافة قيمة تعداد SdfVersion.

الميزات الجديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  customBiddingAlgorithms	إنشاء تصحيح uploadScript
  customBiddingAlgorithms.scripts	إنشاء الحصول على list
  الوسائط	تحميل

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  SdfVersion	SDF_VERSION_5_4

14 أيلول (سبتمبر) 2021

تمت إضافة إتاحة الاستهداف القريب ضمن نوعَي الاستهداف TARGETING_TYPE_BUSINESS_CHAIN و TARGETING_TYPE_POI.

تمت إضافة إمكانية البحث عن خيارات الاستهداف المتاحة TARGETING_TYPE_BUSINESS_CHAIN و TARGETING_TYPE_POI باستخدام targetingTypes.targetingOptions.search، لأنه لا يمكن استردادها من خلال طريقة targetingTypes.targetingOptions.get أو targetingTypes.targetingOptions.list.

تم إدخال حقلَي sharedAdvertiserIds وcustomBiddingAlgorithmState جديدَين إلى مورد "خوارزمية عروض الأسعار المخصّصة" وإضافة دعم لنوع خوارزمية عروض الأسعار المخصّصة GOAL_BUILDER_BASED.

تمت إضافة قيمتين جديدتين إلى التعداد Exchange.

الميزات الجديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  نص الطلب الخاص بـ TargetOptions.search	businessChainSearchTerms poiSearchTerms

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Exchange	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• يمكن الآن فلترة طرق القوائم التالية حسب السمات التالية:

  الطريقة	الحقول
  customBiddingAlgorithms.list	customBiddingAlgorithmState

4 آب (أغسطس) 2021

تمت إضافة دعم بشأن استهداف المستودع الإعلاني الذي تم تفعيل القياس المفتوح فيه ضمن نوع الاستهداف TARGETING_TYPE_OMID.

تمت زيادة الحد الأقصى لعدد خيارات الاستهداف المحدّدة التي يمكن عرضها في صفحة واحدة ضمن طرق قوائم خيارات الاستهداف المختلفة التي تم تحديد المعلن والحملة وطلب الإدراج وتفاصيل الإعلان باستخدام مَعلمة الطريقة pageSize.

الميزات الجديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  TargetingType	TARGETING_TYPE_OMID

• تمت زيادة الحد الأقصى لحجم الصفحة في طرق القوائم التالية:

  الطريقة	الحد الأقصى الجديد لحجم الصفحة
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5,000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5,000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5,000
  advertisers.targetingTypes.assignedTargetingOptions.list	5,000

26 أيار (مايو) 2021

تم إطلاق خدمة advertisers.invoices، والتي تتيح للمستخدمين ما يلي:

• استرداد الفواتير الصادرة إلى أحد المعلنين خلال شهر محدد.
• ابحث عن رمز العملة الذي استخدمه أحد المعلِنين خلال شهر معيّن.

تمت إضافة الحقل campaignBudgets إلى مورد الحملة. يمكن ربط شرائح الميزانية الخاصة بطلبات الإدراج بميزانية حملة، ما يقصر مجموع ميزانية القطاعات المرتبطة به على إجمالي مبلغ ميزانية الحملة.

تمت إضافة دعم لاستهداف موضع الإعلان في المحتوى المدمج مع المحتوى ضمن نوع الاستهداف الجديد TARGETING_TYPE_NATIVE_CONTENT_POSITION.

تم تقديم حقل prismaEnabled جديد لمورد المعلِن، ما أتاح للمستخدمين تفعيل الدمج مع أداة Prisma من Mediaocean.

تم تفعيل قيمة التعداد ENTITY_STATUS_PAUSED لحقل المعلِن entityStatus.

الميزات الجديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  advertisers.invoices	list lookupInvoiceCurrency

• تمت إضافة الحقول التالية:

  المورد	الحقول
  المعلِن	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  الحملة	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• قيم التعداد التالية صالحة الآن للحقول التالية:

  المورد	الحقل	القيم
  المعلِن	entityStatus	ENTITY_STATUS_PAUSED

29 نيسان (أبريل) 2021

تمت إضافة حقول جديدة إلى موارد القناة وقائمة الكلمات الرئيسية السلبية التي تعرض عدد العناصر باستخدام المورد للاستهداف. تم تفعيل مواقع filter الجديدة لطريقة قائمة العناصر التي تسمح للمستخدم باسترداد العناصر التي تستخدم قنوات محدّدة أو قوائم كلمات رئيسية سلبية في استهدافه فقط.

الميزات الجديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  القناة	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• يمكن الآن فلترة طرق القوائم التالية حسب السمات التالية:

  الطريقة	الحقول
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

30 آذار (مارس) 2021

تمت إضافة طريقة جديدة إلى خدمة العناصر تؤدي إلى إنشاء عنصر باستخدام الإعدادات التلقائية. وتستند هذه القيم التلقائية إلى نوع العنصر المحدّد، بالإضافة إلى الإعدادات والاستهداف المحدّد لطلب الإدراج الرئيسي.

تم تفعيل استرداد استهداف الحملة من خلال خدمة استهداف حملة جديدة وطريقة قوائم مجمّعة إضافية.

تم توسيع استهداف التطبيقات للسماح باستهداف التطبيقات على المزيد من الأنظمة الأساسية.

تم إجراء تغييرات متعددة على خدمات advertisers.channels.sites وpartners.channels.sites وadvertisers.negativeKeywordLists.negativeKeywords للسماح بإدارة محتوى القناة وقائمة الكلمات الرئيسية السلبية بسهولة. وتشمل هذه التغييرات ما يلي:

• إضافة طرق replace، التي تتيح للمستخدم استبدال المحتوى الحالي بالكامل في قناة أو قائمة كلمات رئيسية سلبية.
• إزالة الشرط الذي يقضي بعدم تضمين أي عناصر حالية في حقلي createdSites أو createdNegativeKeywords لطلبات التعديل المجمَّع.
• يشير ذلك إلى الزيادة في الحد الأقصى لعدد العناصر التي يمكن عرضها على صفحة واحدة ضمن قائمة المواقع الإلكترونية أو استجابة إدراج كلمات رئيسية سلبية.

الميزات الجديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	الحصول على list
  advertisers.channels.sites	استبدال
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	استبدال
  partners.channels.sites	استبدال

• تمت إضافة الحقول التالية:

  المورد	الحقول
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• تمت زيادة الحد الأقصى لحجم الصفحة في طرق القوائم التالية:

  الطريقة	الحد الأقصى القديم لحجم الصفحة	الحد الأقصى الجديد لحجم الصفحة
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1,000
  partners.channels.sites.list	100	10000

عمليات الإيقاف

• لا يمكن تعيين قيم التعداد التالية لموارد جديدة أو حالية:

  التعداد	القيم
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

24 شباط (فبراير) 2021

تم تقديم خدمة استهداف طلب إدراج جديدة وطريقة إضافية للقائمة المجمّعة للسماح باسترداد الاستهداف المحدّد لطلبات الإدراج. تم توسيع مورد المواد الإبداعية، مع إضافة حقول مواد إبداعية للإخراج فقط لاستخدامها من قِبل تصاميم الإعلانات الصوتية التابعة لجهات خارجية. تمت إضافة أنواع جديدة من أهداف الأداء لاستخدامها حسب موارد طلب الإدراج وموارد الحملة.

الميزات الجديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	الحصول على قائمة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  تصميم الإعلان	mp3Audio oggAudio

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  ContentInstreamPosition	CONTENT_INSTREAM_POSITION_UNKNOWN
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_CLICK_CVR PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR PERFORMANCE_GOAL_TYPE_VCPM PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_VTR

27 كانون الثاني (يناير) 2021

تم تفعيل استرداد وإدارة طلبات الإدراج من التلفزيون والعناصر الأعلى في السطر الأول من خلال إطلاق حقل InsertionOrderType جديد وقيمة تعداد جديدة LineItemType. تمت إضافة دعم لعناصر التطبيق للأجهزة الجوّالة من خلال حقل العناصر mobileApp. دعم موسَّع Exchange وجمهور Google وSDF من خلال قيم تعداد إضافية. تم تقديم إمكانية فلترة وترتيب قيم advertisers.list حسب تاريخ آخر تعديل.

الميزات الجديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  Exchange	EXCHANGE_SHARETHROUGH EXCHANGE_SOUNDCAST
  GoogleAudienceType	GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC GOOGLE_AUDIENCE_TYPE_LIFE_EVENT
  LineItemType	LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP
  SdfVersion	SDF_VERSION_5_3

• يمكن الآن ترتيب طرق القوائم التالية وتصفيتها باستخدام الحقول التالية:

  الطريقة	الحقول
  المعلنون	updateTime

4 كانون الأول (ديسمبر) 2020

تمت إضافة إمكانية البحث عن خيارات استهداف منطقة جغرافية وفلترة نتائج طرق متعددة لقوائم الموارد حسب آخر تعديل لها. تم تقديم LineItemتحذيرMessage جديد لإعلام المستخدمين بوقت استخدام أحد تفاصيل الاستهداف الجغرافي الذي تم إيقافه نهائيًا.

الميزات الجديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  targetingTypes.targetingOptions	بحث

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• يمكن الآن ترتيب طرق القوائم التالية وتصفيتها باستخدام الحقول التالية:

  الطريقة	الحقول
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

5 تشرين الثاني (نوفمبر) 2020

تمت إضافة إمكانية إنشاء مشغِّلات يدوية وتعيينها وتفعيلها لبدء إنفاق العناصر المرتبطة. تم تقديم خيارات توسيع نطاق الاستهداف التي يمكن، عند ضبطها، أن توسِّع استهداف أحد تفاصيل الإعلانات لتشمل مستخدمين مشابهين لهم في شرائح الجمهور المستهدَفة. تم إرفاق حقول رقم تعريف الشريحة المخصّصة بعنصرَي DoubleVerify وIntegral Ad Science المستخدَمَين في استهداف عمليات التحقّق التابعة لجهات خارجية.

الميزات الجديدة

• تمت إضافة الخدمات التالية:

  الخدمة	الطُرق
  advertisers.manualTriggers	تفعيل إنشاء إيقاف الحصول على قائمة رمز التصحيح

• تمت إضافة الحقول التالية:

  المورد	الحقول
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• يمكن الآن فلترة طرق القوائم التالية حسب الحقول التالية:

  الطريقة	الحقول
  advertisers.lineItems.list	filter.triggerId

12 تشرين الأول (أكتوبر) 2020

تم تقديم رسائل تحذير قابلة للاسترداد إلى مورد تفاصيل الإعلان ونوع هدف أداء نسبة النقر إلى الظهور. تمت إضافة warningMessages كحقل قابل للفلترة عند إدراج العناصر.

بالإضافة إلى الميزات الجديدة، أصبحت حدود الحصص الجديدة سارية الآن وتتوفّر مستندات جديدة حول استخدام الطلبات المجمّعة.

الميزات الجديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  LineItem	warningMessages

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• يمكن الآن فلترة طرق القوائم التالية حسب الحقول التالية:

  الطريقة	الحقول
  advertisers.lineItems.list	warningMessages

28 آب (أغسطس) 2020

تمت إضافة حقول جديدة إلى استجابة طريقة تدقيق المعلن والحقول الجديدة القابلة للفلترة إلى طرق القوائم المختلفة.

الميزات الجديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  المعلِنون.نص استجابة التدقيق	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• يمكن الآن فلترة طرق القوائم التالية حسب الحقول التالية:

  الطريقة	الحقول
  advertisers.list	advertiserId displayName
  advertisers.campaigns.list	campaignId displayName
  advertisers.insertionOrders.list	budget.budget_segments.date_range.end_date displayName
  advertisers.lineItems.list	displayName lineItemId
  targetingTypes.targetingOptions.list	carrierAndIspDetails.type geoRegionDetails.geo_region_type

4 آب (أغسطس) 2020

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

الميزات الجديدة

• تمت إضافة الخدمات التالية:

  الخدمة	الطُرق
  customBiddingAlgorithms	الحصول على قائمة
  الشركاء	bulkEditPartnerAssignedTargetingOptions الحصول على قائمة
  partners.targetingTypes.assignedTargetingOptions	إنشاء حذف الحصول على قائمة
  المستخدمون	bulkEditAssignedUserRoles إنشاء حذف الحصول على قائمة رمز التصحيح

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  المعلنون	التدقيق

• تمت إضافة الحقول التالية:

  المورد	الحقول
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• يمكن الآن ترتيب طرق القوائم التالية وتصفيتها باستخدام الحقول التالية:

  الطريقة	الحقول
  advertisers.lineItems.list	flight.dateRange.endDate

• تمت إضافة النطاقات التالية لاستخدامها مع الخدمات التالية:

  النطاق	الخدمات
  https://www.googleapis.com/auth/display-video-user-management	المستخدمون

24 حزيران (يونيو) 2020

تم إطلاق تعديل صغير من خلال إضافة طريقة إنشاء لقنوات الشركاء والمعلنين، وحقول جديدة في FirstAndThirdPartyAudience، وقيم تعداد إضافية Exchange.

الميزات الجديدة

• تمت إضافة الخدمات التالية:

  الخدمة	الطُرق
  advertisers.channels	إنشاء
  partners.channels	إنشاء

• تمت إضافة الحقول التالية:

  المورد	الحقول
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType الوصف displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• تمت إضافة قيم التعداد التالية:

  التعداد	القيم
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• يمكن الآن فلترة طرق القوائم التالية حسب الحقول التالية:

  الطريقة	الحقول
  advertisers.creatives.list	creativeId

2 حزيران (يونيو) 2020

توفير إمكانية إنشاء مجموعة فرعية من الكيانات القابلة للاستهداف وتصحيحها وملؤها، كما تمت إضافة إمكانية تعديل الاستهداف على مستوى المعلِن لثلاثة أنواع استهداف: القناة واستبعاد تصنيفات المحتوى الرقمي واستبعاد فئات حسّاسة.

الميزات الجديدة

• تمت إضافة الخدمات التالية:

  الخدمة	الطُرق
  advertisers.channels.sites	bulkEdit إنشاء حذف قائمة
  advertisers.locationLists.assignedLocations	bulkEdit إنشاء حذف قائمة
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit إنشاء حذف قائمة
  advertisers.targetingTypes.assignedTargetingOptions	إنشاء حذف الحصول على قائمة
  inventorySourceGroups.assignedInventorySources	bulkEdit إنشاء حذف قائمة
  partners.channels.sites	bulkEdit إنشاء حذف قائمة

• تمت إضافة الطرق التالية:

  الخدمة	الطُرق
  المعلنون	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	رمز التصحيح
  advertisers.locationLists	إنشاء رمز التصحيح
  advertisers.negativeKeywordLists	إنشاء حذف رمز التصحيح
  inventorySourceGroups	إنشاء حذف رمز التصحيح
  partners.channels	رمز التصحيح

• تمت إضافة الحقول التالية:

  المورد	الحقول
  معلِن	servingConfig
  تصميم الإعلان	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

27 نيسان (أبريل) 2020

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

الميزات الجديدة

تمت إضافة الخدمات التالية:

الخدمة	الطُرق
المعلنون	إنشاء حذف الحصول على قائمة رمز التصحيح
advertisers.assets	تحميل
advertisers.campaigns	إنشاء حذف الحصول على قائمة رمز التصحيح
advertisers.channels	الحصول على قائمة
advertisers.creatives	إنشاء حذف الحصول على قائمة رمز التصحيح
advertisers.insertionOrders	إنشاء حذف الحصول على قائمة رمز التصحيح
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions إنشاء حذف الحصول على قائمة رمز التصحيح
advertisers.lineItems.targetingTypes.assignedTargetingOptions	إنشاء حذف الحصول على قائمة
advertisers.locationLists	الحصول على قائمة
advertisers.negativeKeywordLists	الحصول على قائمة
combinedAudiences	الحصول على قائمة
customLists	الحصول على قائمة
firstAndThirdPartyAudiences	الحصول على قائمة
floodlightGroups	الحصول على رمز التصحيح
googleAudiences	الحصول على قائمة
inventorySourceGroups	الحصول على قائمة
inventorySources	الحصول على قائمة
partners.channels	الحصول على قائمة
partners.channels	الحصول على قائمة

9 آذار (مارس) 2020

تم إطلاق الإصدار 1 من "مساحة العرض والفيديو 360 API". هذا هو الإصدار الأولي من واجهة برمجة التطبيقات.

المشاكل المعروفة

بلا عُري