تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

Marketplace API

الإصدار 1.0

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

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

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

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

التاريخ	ملاحظات
‫14 ديسمبر 2025	تتوفّر الآن مراجع `curatedPackages` و`mediaPlanners` للمنسّقين في الإصدار v1alpha. تم إيقاف الحقل `accountID` في المورد `mediaPlanners` نهائيًا.
‫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	أضفنا الحقلَين `detectedCategoriesTaxonomy` و`detectedCategories` إلى CreativeServingDecision.
‫30 يوليو 2024	تمت إضافة قيمة التعداد PUBLISHER_FIRST_PARTY_ID إلى `PretargetingConfig`.
‫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	تم إطلاق إذن وصول العميل كإصدار تجريبي مفتوح. يمكنك الآن السماح للمشترين من عملائك بالوصول مباشرةً إلى "سوق الشراة المعتمَدون" ليتمكّنوا من الاطّلاع على الصفقات والتفاوض بشأنها والموافقة عليها. ويمكن لتطبيقك تنفيذ العمليات آليًا التي كان يجب تنفيذها يدويًا في قسم العملاء ضمن علامة التبويب إعدادات حساب المشتري في "المشترون المعتمَدون".

إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0‏ ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0‏. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers‏. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.

تاريخ التعديل الأخير: 2025-12-10 (حسب التوقيت العالمي المتفَّق عليه)