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

Marketplace API

الإصدار 1.0

التاريخ ملاحظات
‫14 ديسمبر 2025
  • تم إيقاف الحقل accountID في المورد mediaPlanners نهائيًا.
‫10 نوفمبر 2025
  • تمت إضافة الحقل floorPriceCpm إلى AuctionPackage.
  • تمت إضافة إمكانية استخدام السمة setReadyToServe على مستوى مقدّم عرض السعر.
‫26 أغسطس 2025
  • يُسمح فقط بأحجام المساحات الإعلانية من نوع PIXEL لاستهداف حجم المساحة الإعلانية عند طلب 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 الإطلاق الأولي لواجهة برمجة التطبيقات في "سوق الشراة المعتمَدون"، والتي تتيح لك:
  • اقتراح الصفقات والتفاوض بشأنها مع الناشرين
  • استرداد الصفقات النهائية ومقاييس حالة الصفقات
  • إدارة الاشتراكات في حزم المزادات
  • إدارة العملاء ومستخدمي العملاء
  • استكشاف الملفات الشخصية للناشرين

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

التاريخ ملاحظات
‫19 أكتوبر 2026
  • تمت إضافة mediaPlanners.search للبحث عن حسابات منسق وسائط الإعلان حسب رقم تعريف حساب منصّة طلب الإعلانات (DSP).
‫25 أغسطس 2026
  • تمت إضافة الحقل userListId إلى DataSegment.
‫20 يوليو 2026
‫29 يونيو 2026
‫14 ديسمبر 2025
  • The curatedPackages and mediaPlanners resources are now available for curators in 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

التاريخ ملاحظات
‫10 نوفمبر 2026 تمت إضافة مَعلمة طلب البحث adCategoryTaxonomyOverride إلى الطرق buyers.creatives.get و buyers.creatives.list و bidders.creatives.list للسماح لمقدّمي عروض الأسعار بتجاوز عرض الأسعار AdCategoryTaxonomy المستخدَمة في الردّ. تمت إضافة قيمة التعداد IAB_CONTENT_2_2 إلى AdCategoryTaxonomy. لا يمكن ضبط الإصدار 2.2 من تصنيف المحتوى الصادر عن مكتب الإعلانات التفاعلية (IAB) كتصنيف لفئات الإعلانات في حسابات "الشراة المعتمَدون" أو "عرض الأسعار المفتوح" في الوقت الحالي.
‫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 تشرين الأول (أكتوبر) 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 الإطلاق الأولي لواجهة برمجة التطبيقات Real-time Bidding 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

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