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

Marketplace API

الإصدار 1.0

التاريخ ملاحظات
‫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

التاريخ ملاحظات
‫11 يونيو 2025
  • الإصدار الأولي من واجهة برمجة التطبيقات v1beta.
  • يتوفّر المرجع dataSegments الآن في الإصدار v1beta.
    • تغيّر مسار المرجع الخاص بـ dataSegments من buyers/{accountId}/dataSegments في الإصدار v1alpha إلى curators/{accountId}/dataSegments في الإصدار v1beta

الإصدار الأوّلي 1.0

التاريخ ملاحظات
‫12 يونيو 2024
  • الإصدار الأولي من واجهة برمجة التطبيقات v1alpha.

Real-time Bidding API

الإصدار 1.0

التاريخ ملاحظات
‫1 مايو 2025 قيمة متوقفة للسمة GOOGLE_RTB من مساحة التعداد BidProtocol.
‫24 فبراير 2025 تمت إضافة القيمة الجديدة GOOGLE_AD_CATEGORY_TAXONOMY إلى مساحة التعداد AdCategoryTaxonomy.
‫13 فبراير 2025 تم إيقاف الفئات المحظورة المعلَن عنها في تصميم الإعلان.
‫6 أغسطس 2024
‫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 الإطلاق الأوّلي لواجهة برمجة التطبيقات لعرض الأسعار في الوقت الفعلي، بهدف استبدال واجهات برمجة التطبيقات Ad Exchange Buyer وAd Exchange Buyer II في نهاية المطاف

قديمة

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

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

تمت إضافة الحالة OVERDELIVERED_IMPRESSION إلى التعداد Status الخاص بـ NonBillableWinningBidStatusRow.

9/29/2023

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

  • accounts.clients
  • accounts.creatives
  • accounts.finalizedProposals
  • accounts.products
  • accounts.proposals
  • accounts.publisherProfiles
  • accounts.clients
5/24/2021

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

20/8/2020

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

5/6/2020

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

2016/3/9

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