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

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

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

الإصدار 1.0 alpha

التاريخ ملاحظات
‫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 تم إيقاف الفئات المحظورة المعلَن عنها في المواد الإبداعية.
‫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 إلى مرجع Native Creatives، والذي يقبل إما 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 (متوقّف نهائيًا)

التاريخ ملاحظات
‎11/8/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.

3/9/2016

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