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

تقدّم هذه الصفحة ملاحظات الإصدار لواجهة برمجة التطبيقات Display & Video 360 API.

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

‫22 أكتوبر 2024

ميزات جديدة

تمت إضافة ميزة استخدام هدف الأداء "تكلفة المشاهدة".

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

تمت إضافة إعدادات جديدة لأمان العلامة التجارية في Adloox ضمن استهداف مصادقة تابعة لجهة خارجية.

تمت إضافة إمكانية تنزيل ملفات البيانات المنظَّمة بالتنسيق 8، والتي قيد الاختبار التجريبي المغلق حاليًا.

v3

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

  عنصر

  الحقول

  Adloox

  adultExplicitSexualContent armsAmmunitionContent crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent deathInjuryMilitaryConflictContent debatedSensitiveSocialIssueContent displayIabViewability excludedFraudIvtMfaCategories hateSpeechActsAggressionContent illegalDrugsTobaccoEcigarettesVapingAlcoholContent misinformationContent obscenityProfanityContent onlinePiracyContent spamHarmfulContent terrorismContent videoIabViewability

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

القيم المتوقّفة

تمّ إيقاف الإصدار 5.5 من SDF نهائيًا في 3 تشرين الأول (أكتوبر) 2024.

v3

• تم إيقاف قيم التعداد التالية نهائيًا:

  Enum	القيم
  SdfVersion	SDF_VERSION_5_5

15 آب (أغسطس) 2024

ميزات جديدة

تمت إضافة إمكانية استخدام نوع Exchange في Netflix.

v3

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  Exchange	EXCHANGE_NETFLIX

v2

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  Exchange	EXCHANGE_NETFLIX

15 تموز (يوليو) 2024

ميزات جديدة

تمت إضافة إمكانية تنزيل ملفات البيانات المنظَّمة للعناصر والمجموعات الإعلانية بتنسيق QA في الإصدار 3.

v3

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

  المورد	الحقول
  IdFilter	adGroupQaIds lineItemQaIds

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

17 حزيران (يونيو) 2024

ميزات جديدة

تمت إتاحة إدارة استهداف الكلمات الرئيسية المحدّد على مستوى المعلِن.

تمت إضافة حقل optimizationObjective جديد إلى مورد طلب الإدراج. لا تتوفّر optimizationObjective إلا للعملاء المدرَجين في القائمة المسموح بها.

v3

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

  المورد	الحقول
  InsertionOrder	optimizationObjective

• تتيح الطرق التالية الآن أنواع الاستهداف التالية:

  نوع الاستهداف	الطرق
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

v2

• تتيح الطرق التالية الآن أنواع الاستهداف التالية:

  نوع الاستهداف	الطرق
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

30 مايو 2024

ميزات جديدة

تمت إضافة إمكانية استخدام الإصدار 7.1 من ملفات البيانات المنظَّمة (SDF).

v3

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  SdfVersion	SDF_VERSION_7_1

v2

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  SdfVersion	SDF_VERSION_7_1

‫23 أبريل 2024

ميزات جديدة

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

v3

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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	consent
  MobileDeviceIdList	consent

v2

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

  المورد	الحقول
  ContactInfoList	consent
  MobileDeviceIdList	consent

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

ميزات جديدة

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

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

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

v3

• تمت إزالة قيم القائمة التالية:

  Enum	القيم
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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

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

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

v3

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

  الخدمة	الطرق
  advertisers.adGroupAds	الحصول list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions الحصول list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	الحصول list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create الحصول list

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

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

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

  الطريقة	التغييرات
  advertisers.locationLists.create	تتيح الآن إنشاء موارد TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.patch	تتيح الآن إمكانية تعديل TARGETING_LOCATION_TYPE_PROXIMITY LocationList من الموارد.
  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	kpi
  شريك	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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

• تمت إزالة قيم القائمة المحدَّدة التالية:

  Enum	القيم
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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

ميزات جديدة

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

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

v2

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

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

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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 لإصدار 6 من ملفات البيانات المنظَّمة (SDF) في الإصدارَين 1 و2.

v2

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  SdfVersion	SDF_VERSION_6

v1

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  SdfVersion	SDF_VERSION_6

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

ميزات جديدة

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

v2

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

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

ميزات جديدة

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

تمت إضافة إمكانية إجراء أربعة عمليات تبادل إضافية في الإصدارَين 1 و2.

v2

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

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

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

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

ميزات جديدة

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

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

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

تمت إضافة إمكانية استرداد عناصر YouTube والشركاء التي توفّر محتوى غير قابل للتقديم أو الإيقاف، والتي يتم تمييزها بثلاث قيم جديدة من LineItemType.

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

v2

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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	create حذف
  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	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	environment
  ExchangeAssignedTargetingOptionDetails	الاستبدال
  GenderAssignedTargetingOptionDetails	gender
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	إمكانية المشاهدة

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

  Enum	القيم
  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:

  Enum	القيم
  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:

  Enum	القيم
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

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

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

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

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

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

ميزات جديدة

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

  الخدمة	الطرق
  guaranteedOrders	create editGuaranteedOrderReadAccessors الحصول list patch
  inventorySources	create editInventorySourceReadWriteAccessors patch

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

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

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

تمّ إدخال حقل reservationType جديد في موارد InsertionOrder وLineItem يحدّد ما إذا كان المورد مضمونًا من خلال العلامات أو من خلال العروض الإعلانية المبرمَجة أو غير مضمون.

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

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

ميزات جديدة

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

  الخدمة	الطرق
  firstAndThirdPartyAudiences	create editCustomerMatchMembers patch

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

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

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

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

ميزات جديدة

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

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

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

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

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

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

ميزات جديدة

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

  الخدمة	الطرق
  customBiddingAlgorithms	create patch uploadScript
  customBiddingAlgorithms.scripts	create الحصول list
  media	تحميل

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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
  نص طلب TargetingOptions.search	businessChainSearchTerms poiSearchTerms

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  TargetingType	TARGETING_TYPE_OMID

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

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• أصبحت قيم النطاق المحدّد التالية صالحة الآن للحقول التالية:

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

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

تمت إضافة حقول جديدة إلى موردَي القناة و قائمة الكلمات الرئيسية السلبية لعرض عدد سطور العناصر التي تستخدِم المورد لاستهدافها. تم تفعيل filter خصائص جديدة لطريقة قائمة تفاصيل الإعلان تسمح للمستخدم ب retrieving retrieve only line items that are using specific channels or keyword negative lists in their targeting.

ميزات جديدة

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

  المورد	الحقول
  القناة	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	1000
  partners.channels.sites.list	100	10000

الميزات المتوقّفة نهائيًا

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

  Enum	القيم
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

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

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

ميزات جديدة

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

  الخدمة	الطرق
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get list

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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. إتاحة الاستبدال وجمهور Google و SDF الموسّعة من خلال قيم محدّدة إضافية تمّت إضافة ميزة الفلترة وترتيب قيم advertisers.list حسب وقت آخر تعديل.

ميزات جديدة

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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

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

ميزات جديدة

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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	تفعيل create إيقاف get list تصحيح

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

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

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

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

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

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

ميزات جديدة

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

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

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

28 آب (أغسطس) 2020

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

ميزات جديدة

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

  المورد	الحقول
  Advertisers.Audit Response Body	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	get list
  partners	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create حذف get list
  مستخدمين	bulkEditAssignedUserRoles create حذف get list تصحيح

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

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

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  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 جديدة، وقيمًا إضافية لقائمة الاستبدال.

ميزات جديدة

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

  الخدمة	الطرق
  advertisers.channels	create
  partners.channels	create

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

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

• تمت إضافة قيم النطاق المحدّد التالية:

  Enum	القيم
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

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

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

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

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

ميزات جديدة

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

  الخدمة	الطرق
  advertisers.channels.sites	bulkEdit create حذف list
  advertisers.locationLists.assignedLocations	bulkEdit create حذف list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create حذف list
  advertisers.targetingTypes.assignedTargetingOptions	create حذف get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create حذف list
  partners.channels.sites	bulkEdit create حذف list

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

  الخدمة	الطرق
  المعلِنون	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	تصحيح
  advertisers.locationLists	create تصحيح
  advertisers.negativeKeywordLists	create حذف تصحيح
  inventorySourceGroups	create حذف تصحيح
  partners.channels	تصحيح

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

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

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

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

ميزات جديدة

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

الخدمة	الطرق
المعلِنون	create حذف get list تصحيح
advertisers.assets	تحميل
advertisers.campaigns	create حذف get list تصحيح
advertisers.channels	get list
advertisers.creatives	create حذف get list تصحيح
advertisers.insertionOrders	create حذف get list تصحيح
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create حذف get list تصحيح
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create حذف get list
advertisers.locationLists	get list
advertisers.negativeKeywordLists	get list
combinedAudiences	get list
customLists	get list
firstAndThirdPartyAudiences	get list
floodlightGroups	get تصحيح
googleAudiences	get list
inventorySourceGroups	get list
inventorySources	get list
partners.channels	get list
partners.channels	get list

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

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

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

بلا عُري