یادداشت های انتشار

API بازار

نسخه ۱.۰

تاریخ	یادداشت‌ها
دهم نوامبر ۲۰۲۵	فیلد floorPriceCpm به AuctionPackage اضافه شد. پشتیبانی در سطح پیشنهاددهنده برای setReadyToServe اضافه شد.
۲۶ آگوست ۲۰۲۵	فقط اندازه‌های موجودی PIXEL برای هدف‌گیری اندازه موجودی هنگام فراخوانی buyers.proposals.sendRfp مجاز هستند.
۲۷ فوریه ۲۰۲۵	فیلد buyerPermissionType به Deal اضافه شد.
۹ دسامبر ۲۰۲۴	فیلد dealOwnerSeatId به AuctionPackage اضافه شد.
۱۷ ژوئن ۲۰۲۴	اشکالی که باعث می‌شد از buyers.proposals.addNote برای پیشنهادهای حراج خصوصی استفاده شود، برطرف شد . این یک گردش کار معتبر نیست زیرا این نوع معامله شامل مذاکره نمی‌شود.
۶ ژوئن ۲۰۲۴	پشتیبانی از pausing و resuming معاملات ترجیحی اضافه شد.
۲۵ آوریل ۲۰۲۴	پشتیبانی از پارامتر orderBy به bidders.auctionPackages.list اضافه شده است.
۲۳ آوریل ۲۰۲۴	مقدار هدف‌گیری excludeDensitiveCategoryIds به MarketplaceTargeting اضافه شد. مقدار هدف‌گیری vertical_targeting به MarketplaceTargeting اضافه شد.
۱۵ آوریل ۲۰۲۴	bidders.auctionPackages.list برای فهرست کردن بسته‌های حراج در سطح پیشنهاددهنده معرفی شد. بسته‌های حراجی که توسط این روش برگردانده می‌شوند، برنامه‌ریزان رسانه‌ای را که در آن مشترک شده‌اند با فیلد subscribedMediaPlanners فهرست می‌کنند. فیلد subscribedBuyers به AuctionPackage اضافه شد. فیلد subscribedMediaPlanners به AuctionPackage اضافه شد. فیلد «شناسه‌های واجد شرایط صندلی» (validableSeatIds) به AuctionPackage اضافه شد.
۷ مارس ۲۰۲۴	مقدار شمارشی PUBLISHER_PROVIDED_ID به PretargetingConfig اضافه شد.
۲۹ فوریه ۲۰۲۴	فیلد mediaPlanner را به Deal معرفی کرد. فیلد «شناسه‌های واجد شرایط صندلی» (invalidableSeatIds) به Deal اضافه شد. اگر حساب کاربری مربوط به billedBuyer مربوط به یک معامله متعلق به یک حساب برنامه‌ریز رسانه باشد، این حساب پر نخواهد شد.
۲۹ نوامبر ۲۰۲۳	مقدار شمارشی AUDIO به CreativeFormat اضافه شد. مقدار شمارشی LG_TV به AppStoreType اضافه شد.
۱۱ اکتبر ۲۰۲۱	راه‌اندازی اولیه‌ی رابط برنامه‌نویسی کاربردی (API) بازار خریداران مجاز ، که به شما امکان می‌دهد: پیشنهاد و مذاکره برای عقد قرارداد با ناشران بازیابی معاملات نهایی شده و معیارهای سلامت معامله مدیریت اشتراک‌های بسته‌های حراج مدیریت کلاینت‌ها و کاربران کلاینت پروفایل‌های ناشران را کشف کنید

نسخه ۱.۰ بتا

تاریخ	یادداشت‌ها
۱۱ ژوئن ۲۰۲۵	انتشار اولیه API نسخه v1beta. منبع dataSegments اکنون در نسخه v1beta در دسترس است. مسیر منابع برای dataSegments از buyers/{accountId}/dataSegments در نسخه ۱alpha به curators/{accountId}/dataSegments در نسخه ۱beta تغییر کرده است.

نسخه ۱.۰ آلفا

تاریخ	یادداشت‌ها
۱۲ ژوئن ۲۰۲۴	انتشار اولیه API نسخه v1alpha.

API پیشنهاد قیمت در لحظه

نسخه ۱.۰

تاریخ	یادداشت‌ها
۱ مه ۲۰۲۵	مقدار GOOGLE_RTB از فضای شمارشی BidProtocol منسوخ شده است.
۲۴ فوریه ۲۰۲۵	مقدار جدید GOOGLE_AD_CATEGORY_TAXONOMY به فضای شمارشی AdCategoryTaxonomy اضافه شد.
۱۳ فوریه ۲۰۲۵	رده‌های محدود اعلام‌شده در Creative منسوخ شده‌اند.
۶ آگوست ۲۰۲۴	فیلدهای detectedCategoriesTaxonomy و detectedCategories به CreativeServingDecision اضافه شدند.
۳۰ ژوئیه ۲۰۲۴	مقدار شمارشی PUBLISHER_FIRST_PARTY_ID به PretargetingConfig اضافه شد.
۳۱ اکتبر ۲۰۲۳	buyers.userLists.getRemarketingTag و UrlRestriction غیرفعال شده‌اند و در صورت فراخوانی، پاسخ خطا می‌دهند. توصیه می‌کنیم از ویژگی google_ula در تگ Cookie Matching برای اضافه کردن کاربران به لیست کاربران با قرار دادن یک تگ از مرورگرها استفاده کنید. برای اطلاعات بیشتر به مستندات Cookie Matching مراجعه کنید.
۱۲ اکتبر ۲۰۲۳	مقدار شمارشی RENDERING_PLAYABLE به CreativeAttribute اضافه شد.
۱۷ آگوست ۲۰۲۳	buyers.userLists.getRemarketingTag و UrlRestriction منسوخ شده‌اند و در تاریخ 2023/10/31 منقضی خواهند شد. از ویژگی google_ula در تگ Cookie Matching برای اضافه کردن کاربران به لیست کاربران با قرار دادن یک تگ از مرورگرها استفاده کنید. برای اطلاعات بیشتر به مستندات Cookie Matching مراجعه کنید.
۱۷ مارس ۲۰۲۳	فیلد missingCertificate به PolicyTopicEntry اضافه شد.
۷ فوریه ۲۰۲۳	مقادیر enum منسوخ شده زیر را از bidders.endpoints.bidProtocol حذف کرد: باز کردن_2_2 باز کردن_2_3 باز کردن_پروتو_باف_۲_۳ باز کردن_۲_۴ باز کردن_پروتو_باف_۲_۴ باز کردن_2_5 باز کردن_پروتو_باف_۲_۵
۸ نوامبر ۲۰۲۲	مقدار شمارشی جدید OPENRTB_PROTOBUF برای bidders.endpoints.bidProtocol اضافه شد. از این به بعد، فقط یک نسخه OpenRTB در یک زمان پشتیبانی می‌شود. برای استفاده از آخرین نسخه پشتیبانی شده OpenRTB در قالب دلخواه خود، باید OPENRTB_JSON یا OpenRTB_PROTOBUF استفاده کنید. برای جزئیات بیشتر به پست وبلاگ ما در مورد حذف پشتیبانی از نسخه‌های قدیمی OpenRTB مراجعه کنید. فیلدهای شمارشی زیر از bidders.endpoints.bidProtocol منسوخ شده‌اند: باز کردن_2_2 باز کردن_2_3 باز کردن_پروتو_باف_۲_۳ باز کردن_۲_۴ باز کردن_پروتو_باف_۲_۴ باز کردن_2_5 باز کردن_پروتو_باف_۲_۵
۲۰ سپتامبر ۲۰۲۲	فیلد creatives.renderUrl آزمایشی برای نسخه‌های آزمایشی FLEDGE معرفی شد.
۱ سپتامبر ۲۰۲۲	وضعیت CERTIFICATE_REQUIRED برای برخی از افراد خلاق معرفی شد. برای اطلاعات بیشتر به سیاست قمار و بازی‌ها مراجعه کنید.
۲۷ آوریل ۲۰۲۲	انتشار منبع publisherConnections . صرافی‌های پیشنهاد قیمت آزاد می‌توانند از publisherConnections برای مدیریت ارتباطات با ناشران استفاده کنند.
۱ نوامبر ۲۰۲۱	bidders.enpoints.patch برای به‌روزرسانی نقطه پایانی پیشنهاددهنده معرفی شد.
۲۷ مه ۲۰۲۱	یکی از video میدانی به منبع Native Creatives اضافه شد که یا videoVastXml یا videoUrl می‌پذیرد.
۸ اکتبر ۲۰۲۰	فیلدهای openAuctionServingStatus ، openBiddingServingStatus ، dealsServingStatus ، chinaServingStatus و russiaServingStatus به ترتیب با networkPolicyCompliance ، platformPolicyCompliance ، dealsPolicyCompliance ، chinaPolicyCompliance و russiaPolicyCompliance جایگزین شده‌اند.
۲۴ ژوئن ۲۰۲۰	راه‌اندازی اولیه‌ی API پیشنهاد قیمت آنی ، که در نهایت جایگزین APIهای Ad Exchange Buyer و Ad Exchange Buyer II خواهد شد.

میراث

رابط برنامه‌نویسی کاربردی خریدار تبادل تبلیغات (Ad Exchange Buyer API II) منسوخ شده است. به استثنای منابعی که برای عیب‌یابی RTB استفاده می‌شوند، سایر منابع از تاریخ ۲۹ سپتامبر ۲۰۲۳ غیرفعال می‌شوند. اگر نیاز به ادامه استفاده از Marketplace دارید، توصیه می‌کنیم به API Marketplace مهاجرت کنید .

نسخه ۲.۰ (منسوخ شده)

تاریخ	یادداشت‌ها
۸/۱۱/۲۰۲۵	وضعیت OVERDELIVERED_IMPRESSION به Status enum مربوط به NonBillableWinningBidStatusRow اضافه شد.
۹/۲۹/۲۰۲۳	تمام منابع به غیر از منابعی که برای عیب‌یابی RTB استفاده می‌شوند، غیرفعال شده‌اند و در صورت فراخوانی، پاسخ خطا می‌دهند. توصیه می‌کنیم برای ادامه دسترسی به Marketplace از طریق برنامه‌نویسی، به Marketplace API مهاجرت کنید. منابع غیرفعال شامل موارد زیر و تمام منابع فرعی آنها می‌شود: accounts.clients accounts.creatives accounts.finalizedProposals accounts.products accounts.proposals accounts.publisherProfiles accounts.clients
۲۴/۵/۲۰۲۱	روش‌های pause و resume در سطح معامله اضافه شد.
۲۰/۸/۲۰۲۰	فیلد detail به BidMetricsRow اضافه شد.
۵/۶/۲۰۲۰	فیلد reachedQueries به BidMetricsRow اضافه شد. FATAL_VAST_ERROR و LOST_IN_MEDIATION به Status enum مربوط به NonBillableWinningBidStatusRow اضافه شد.
۳/۹/۲۰۱۶	دسترسی مشتری به عنوان یک نسخه بتای باز منتشر شد. اکنون می‌توانید به خریداران مشتری خود اجازه دهید مستقیماً به بازار خریداران مجاز دسترسی داشته باشند تا بتوانند معاملات را مشاهده، مذاکره و تأیید کنند. و برنامه شما می‌تواند عملیاتی را که قبلاً باید به صورت دستی در بخش مشتریان از تب تنظیمات حساب خریداران مجاز انجام می‌شد، به صورت برنامه‌نویسی انجام دهد.