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

Marketplace API

الإصدار 1.0

التاريخ ملاحظات
‫14 ديسمبر 2025
  • تم إيقاف الحقل accountID في المورد mediaPlanners نهائيًا.
‫10 نوفمبر 2025
  • تمت إضافة الحقل floorPriceCpm إلى AuctionPackage.
  • تمت إضافة إمكانية استخدام السمة setReadyToServe على مستوى مقدّم عرض السعر.
‫26 أغسطس 2025
  • يُسمح فقط بأحجام المساحات الإعلانية المتاحة بالبكسل لاستهداف حجم المساحة الإعلانية عند طلب buyers.proposals.sendRfp.
‫27 فبراير 2025
‫9 ديسمبر 2024
‫17 يونيو 2024
‫6 يونيو 2024
  • تمت إضافة إمكانية استخدام الصفقات المفضّلة في pausing وresuming.
‫25 أبريل 2024
‫23 أبريل 2024 تمت إضافة قيمة الاستهداف excludedSensitiveCategoryIds إلى MarketplaceTargeting. تمت إضافة قيمة الاستهداف vertical_targeting إلى MarketplaceTargeting.
‫15 أبريل 2024
  • تم تقديم bidders.auctionPackages.list لإدراج حزم المزادات على مستوى مقدّم عرض السعر. تُدرج حِزم المزادات التي تعرضها هذه الطريقة منسّقي وسائط الإعلان المشتركين فيها من خلال الحقل subscribedMediaPlanners.
  • تمت إضافة الحقل subscribedBuyers إلى AuctionPackage.
  • تمت إضافة الحقل subscribedMediaPlanners إلى AuctionPackage.
  • تمت إضافة الحقل eligibleSeatIds إلى AuctionPackage.
‫7 مارس 2024
‫29 فبراير 2024
  • تمت إضافة الحقل mediaPlanner إلى Deal.
  • تمت إضافة الحقل eligibleSeatIds إلى Deal.
  • لن تتم تعبئة billedBuyer للصفقة إذا كانت تنتمي إلى حساب منسق وسائط الإعلان.
‫29 نوفمبر 2023 تمت إضافة قيمة التعداد AUDIO إلى CreativeFormat. تمت إضافة قيمة التعداد LG_TV إلى AppStoreType.
‫11 أكتوبر 2021 الإصدار الأولي من Authorized Buyers Marketplace API، والذي يتيح لك:
  • اقتراح الصفقات والتفاوض بشأنها مع الناشرين
  • استرداد الصفقات النهائية ومقاييس حالة الصفقات
  • إدارة الاشتراكات في حزم المزادات
  • إدارة العملاء ومستخدمي العملاء
  • استكشاف الملفات الشخصية للناشرين

الإصدار التجريبي 1.0

التاريخ ملاحظات
‫19 أكتوبر 2026
  • تمت إضافة mediaPlanners.search للبحث عن حسابات منسق وسائط الإعلان حسب رقم تعريف الحساب في منصة طلب الإعلانات (DSP).
‫25 أغسطس 2026
  • تمت إضافة الحقل userListId إلى DataSegment.
‫20 يوليو 2026
‫29 يونيو 2026
‫14 ديسمبر 2025
  • أصبح الموردان curatedPackages وmediaPlanners متاحَين الآن لمنسّقي المحتوى في الإصدار v1beta.
  • تم إيقاف الحقل accountID في المورد mediaPlanners نهائيًا.
‫11 يونيو 2025
  • الإصدار الأوّلي من واجهة برمجة التطبيقات v1beta.
  • يتوفّر الآن مورد dataSegments في الإصدار التجريبي v1beta.
    • تم تغيير مسار المورد لـ dataSegments من buyers/{accountId}/dataSegments في v1alpha إلى curators/{accountId}/dataSegments في v1beta

الإصدار 1.0 alpha

التاريخ ملاحظات
‫19 أكتوبر 2026
  • تمت إضافة mediaPlanners.search للبحث عن حسابات منسق وسائط الإعلان حسب رقم تعريف الحساب في منصة طلب الإعلانات (DSP).
‫25 أغسطس 2026
  • تمت إضافة الحقل userListId إلى DataSegment.
‫20 يوليو 2026
‫29 يونيو 2026
‫14 ديسمبر 2025
  • أصبح الموردان curatedPackages وmediaPlanners متاحَين الآن للمنسّقين في الإصدار v1alpha.
  • تم إيقاف الحقل accountID في المورد mediaPlanners نهائيًا.
‫12 يونيو 2024
  • الإصدار الأوّلي من واجهة برمجة التطبيقات v1alpha.

Real-time Bidding API

الإصدار 1.0

التاريخ ملاحظات
‫20 سبتمبر 2026 تم إيقاف الحالة CERTIFICATE_REQUIRED والحقل missingCertificate نهائيًا بعد تعديلات السياسة التي لم تعُد تتطلّب شهادات للمقامرة وألعاب أندية المقامرة على الشبكات الاجتماعية.
‫10 سبتمبر 2026 تمت إضافة الطريقة addDeals إلى المورد buyers.creatives، ما يتيح للمشترين ربط أرقام تعريف الصفقات (بما في ذلك صفقات Programmatic Guaranteed والمزادات الخاصة والصفقات المفضّلة وحِزم Marketplace) بتصميم إعلان.
‫9 يوليو 2026 تم إيقاف الحقل allowed_user_targeting_modes والتعداد UserTargetingMode نهائيًا في PretargetingConfig.
‫1 مايو 2025 القيمة المتوقفة نهائيًا GOOGLE_RTB من مساحة التعداد BidProtocol.
‫24 فبراير 2025 تمت إضافة القيمة الجديدة GOOGLE_AD_CATEGORY_TAXONOMY إلى مساحة التعداد AdCategoryTaxonomy.
‫13 فبراير 2025 تم إيقاف الفئات الخاضعة لقيود والمعلَن عنها نهائيًا في Creative.
‫6 أغسطس 2024
  • تمت إضافة الحقلَين detectedCategoriesTaxonomy وdetectedCategories إلى CreativeServingDecision.
‫30 يوليو 2024
‫31 أكتوبر 2023 تم إيقاف buyers.userLists.getRemarketingTag وUrlRestriction نهائيًا، وسيتم عرض رسالة خطأ في حال استدعائهما. ننصح باستخدام ميزة google_ula في علامة مطابقة ملف تعريف الارتباط لإضافة مستخدمين إلى قائمة المستخدمين من خلال وضع علامة من المتصفّحات. يمكنك الاطّلاع على مزيد من المعلومات في مستندات مطابقة ملفات تعريف الارتباط
‫12 أكتوبر 2023 تمت إضافة قيمة التعداد RENDERING_PLAYABLE إلى CreativeAttribute.
‫17 أغسطس 2023 تم إيقاف buyers.userLists.getRemarketingTag وUrlRestriction نهائيًا وستتم إزالتهما في ‎31/10/2023. استخدِم ميزة google_ula في علامة مطابقة ملف تعريف الارتباط لإضافة مستخدمين إلى قائمة المستخدمين من خلال وضع علامة من المتصفّحات. يمكنك الاطّلاع على مزيد من المعلومات في مستندات مطابقة ملفات تعريف الارتباط
‫17 مارس 2023 تمت إضافة الحقل missingCertificate إلى PolicyTopicEntry.
‫7 فبراير 2023

تمت إزالة قيم التعداد التالية التي تم إيقافها نهائيًا من bidders.endpoints.bidProtocol:

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
‫8 نوفمبر 2022

تمت إضافة قيمة تعداد جديدة OPENRTB_PROTOBUF لسمة bidders.endpoints.bidProtocol. من الآن فصاعدًا، سيتوفّر إصدار واحد فقط من OpenRTB في كل مرة. يجب استخدام OPENRTB_JSON أو OpenRTB_PROTOBUF لاستخدام أحدث إصدار متوافق من OpenRTB بالتنسيق المفضّل لديك. يمكنك الاطّلاع على منشور المدوّنة حول إزالة التوافق مع إصدارات OpenRTB القديمة لمزيد من التفاصيل.

تم وضع علامة "متوقّف نهائيًا" على حقول التعداد التالية من bidders.endpoints.bidProtocol:

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
20 أيلول (سبتمبر) 2022 تم تقديم حقل creatives.renderUrl التجريبي لمراحل التجربة والتقييم في FLEDGE.
1 أيلول (سبتمبر) 2022 تمت إضافة الحالة CERTIFICATE_REQUIRED لبعض تصاميم الإعلانات. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة المقامرة والألعاب.
‫27 نيسان (أبريل) 2022 إصدار المورد publisherConnections. يمكن لشبكات تبادل الإعلانات في "عرض الأسعار المفتوح" استخدام publisherConnections لإدارة الاتصالات مع الناشرين.
‫1 نوفمبر 2021 تمت إضافة bidders.enpoints.patch لتعديل نقطة نهاية مقدِّم عرض السعر.
27 أيار (مايو) 2021 تمت إضافة حقل oneof video إلى مورد تصميمات الإعلانات المدمجة مع المحتوى، والذي يقبل إما videoVastXml أو videoUrl.
8 تشرين الأول (أكتوبر) 2020 تم استبدال الحقول openAuctionServingStatus وopenBiddingServingStatus وdealsServingStatus وchinaServingStatus وrussiaServingStatus بـ networkPolicyCompliance وplatformPolicyCompliance وdealsPolicyCompliance وchinaPolicyCompliance وrussiaPolicyCompliance على التوالي.
24 حزيران (يونيو) 2020 الإطلاق الأولي لواجهة برمجة التطبيقات عرض الأسعار في الوقت الفعلي API، لتحل في النهاية محل واجهتَي برمجة التطبيقات Ad Exchange Buyer وAd Exchange Buyer II.

قديمة

الإصدار 2.0 (متوقّف نهائيًا)

التاريخ ملاحظات
‫11/8/2025

تمت إضافة الحالة OVERDELIVERED_IMPRESSION إلى التعداد Status في NonBillableWinningBidStatusRow.

‫29 سبتمبر 2023

تم إيقاف جميع الموارد نهائيًا باستثناء تلك المستخدَمة لتحديد مشاكل عروض الأسعار في الوقت الفعلي وحلّها، وستعرض استجابة خطأ في حال طلبها. ننصحك بنقل البيانات إلى Marketplace API لمواصلة الوصول إلى Marketplace آليًا. تشمل الموارد التي سيتم إيقافها ما يلي وجميع مواردها الفرعية:

  • accounts.clients
  • accounts.creatives
  • accounts.finalizedProposals
  • accounts.products
  • accounts.proposals
  • accounts.publisherProfiles
  • accounts.clients
‫24 مايو 2021

تمت إضافة الطريقتَين pause وresume على مستوى الصفقة.

‫20/8/2020

تمت إضافة الحقل "detail" إلى BidMetricsRow.

5/6/2020

تمت إضافة الحقل reachedQueries إلى BidMetricsRow. تمت إضافة FATAL_VAST_ERROR وLOST_IN_MEDIATION إلى تعداد Status في NonBillableWinningBidStatusRow.

3/9/2016

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