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

Marketplace API

نسخه 1.0

تاریخ یادداشت‌ها
‫۱۴ دسامبر ۲۰۲۵
  • فیلد accountID در منبع mediaPlanners منسوخ شده است.
‫۱۰ نوامبر ۲۰۲۵
  • فیلد floorPriceCpm را به AuctionPackage معرفی کردیم.
  • پشتیبانی در سطح پیشنهاددهنده برای setReadyToServe اضافه شد.
‫۲۶ اوت ۲۰۲۵
  • هنگام فراخوانی buyers.proposals.sendRfp، فقط اندازه‌های فضای آگهی PIXEL برای هدف‌یابی اندازه فضای آگهی مجاز است.
‫۲۷ فوریه ۲۰۲۵
‫۹ دسامبر ۲۰۲۴
‫۱۷ ژوئن ۲۰۲۴
‫۶ ژوئن ۲۰۲۴
  • پشتیبانی از معامله‌های برگزیده pausing و resuming اضافه شد.
‫۲۵ آوریل ۲۰۲۴
‫۲۳ آوریل ۲۰۲۴ مقدار هدف‌یابی excludedSensitiveCategoryIds به MarketplaceTargeting اضافه شد. مقدار هدف‌یابی vertical_targeting به MarketplaceTargeting اضافه شد.
‫۱۵ آوریل ۲۰۲۴
  • bidders.auctionPackages.list برای فهرست کردن بسته‌های مزایده در سطح پیشنهاددهنده معرفی شد. بسته‌های مزایده‌ای که با این روش برگردانده می‌شوند، طراحان رسانه‌ای را که با فیلد subscribedMediaPlanners در آن مشترک شده‌اند فهرست می‌کند.
  • فیلد subscribedBuyers را به AuctionPackage معرفی کردیم.
  • فیلد subscribedMediaPlanners را به AuctionPackage معرفی کردیم.
  • فیلد eligibleSeatIds را به AuctionPackage معرفی کردیم.
‫۷ مارس ۲۰۲۴
‫۲۹ فوریه ۲۰۲۴
  • فیلد mediaPlanner را به Deal معرفی کردیم.
  • فیلد eligibleSeatIds را به Deal معرفی کردیم.
  • اگر billedBuyer معامله متعلق به حساب طراح رسانه باشد، تکمیل نخواهد شد.
‫۲۹ نوامبر ۲۰۲۳ مقدار شمارشی AUDIO به CreativeFormat اضافه شد. مقدار شمارشی LG_TV به AppStoreType اضافه شد.
‫۱۱ اکتبر ۲۰۲۱ راه‌اندازی اولیه Authorized Buyers Marketplace API که به شما امکان می‌دهد:
  • پیشنهاد و مذاکره درباره معامله‌ها با ناشران
  • بازیابی معامله‌های نهایی‌شده و سنجه‌های سلامت معامله
  • مدیریت اشتراک‌های بسته مزایده
  • مدیریت کارخواه‌ها و کاربران کارخواه
  • کاوش نمایه‌های ناشر

نسخه ۱.۰ بتا

تاریخ یادداشت‌ها
‫۱۹ اکتبر ۲۰۲۶
  • معرفی mediaPlanners.search برای جستجوی حساب‌های طراح رسانه براساس شناسه جایگاه پلاتفرم سمت تقاضا.
‫۲۵ اوت ۲۰۲۶
  • فیلد userListId را به DataSegment معرفی کردیم.
‫۲۰ ژوئیه ۲۰۲۶
‫۲۹ ژوئن ۲۰۲۶
‫۱۴ دسامبر ۲۰۲۵
  • منابع curatedPackages و mediaPlanners اکنون برای موزه‌داران در v1beta دردسترس است.
  • فیلد accountID در منبع mediaPlanners منسوخ شده است.
‫۱۱ ژوئن ۲۰۲۵
  • انتشار اولیه میانای برنامه‌سازی کاربردی v1beta.
  • منبع dataSegments اکنون در v1beta دردسترس است.
    • مسیر منبع برای dataSegments از buyers/{accountId}/dataSegments در v1alpha به curators/{accountId}/dataSegments در v1beta تغییر کرده است

نسخه ۱.۰ آلفا

تاریخ یادداشت‌ها
‫۱۹ اکتبر ۲۰۲۶
  • معرفی mediaPlanners.search برای جستجوی حساب‌های طراح رسانه براساس شناسه جایگاه پلاتفرم سمت تقاضا.
‫۲۵ اوت ۲۰۲۶
  • فیلد userListId را به DataSegment معرفی کردیم.
‫۲۰ ژوئیه ۲۰۲۶
‫۲۹ ژوئن ۲۰۲۶
‫۱۴ دسامبر ۲۰۲۵
  • منابع curatedPackages و mediaPlanners اکنون برای موزه‌داران در v1alpha دردسترس است.
  • فیلد accountID در منبع mediaPlanners منسوخ شده است.
‫۱۲ ژوئن ۲۰۲۴
  • اولین نسخه پخش v1alpha API.

Real-time Bidding API

نسخه 1.0

تاریخ یادداشت‌ها
‫۲۰ سپتامبر ۲۰۲۶ وضعیت CERTIFICATE_REQUIRED و فیلد missingCertificate به‌دنبال به‌روزرسانی‌های خط‌مشی که دیگر برای بازی‌های کازینویی اجتماعی و شرط‌بندی به گواهی نیاز ندارند، منسوخ شده‌اند.
‫۱۰ سپتامبر ۲۰۲۶ روش addDeals به منبع buyers.creatives معرفی شد تا خریداران بتوانند شناسه‌های معامله (ازجمله «تضمین‌شده برنامه‌ای»، «مزایده خصوصی»، «معامله ترجیحی»، و «بسته بازار») را با طرح‌آگهی مرتبط کنند.
‫۹ ژوئیه ۲۰۲۶ فیلد allowed_user_targeting_modes و شمارش UserTargetingMode در PretargetingConfig منسوخ شده است.
‫۱ مه ۲۰۲۵ مقدار منسوخ‌شده GOOGLE_RTB از فضای شمارشی BidProtocol.
‫۲۴ فوریه ۲۰۲۵ مقدار جدید GOOGLE_AD_CATEGORY_TAXONOMY به فضای شمارشی AdCategoryTaxonomy اضافه شد.
‫۱۳ فوریه ۲۰۲۵ دسته‌های محدودشده اعلام‌شده منسوخ در طرح آگهی.
‫۶ اوت ۲۰۲۴
‫۳۰ ژوئیه ۲۰۲۴
‫۳۱ اکتبر ۲۰۲۳ buyers.userLists.getRemarketingTag و UrlRestriction منسوخ شده‌اند و اگر فراخوانی شوند، پاسخ خطا برمی‌گردانند. توصیه می‌کنیم از ویژگی google_ula برچسب «تطابق کوکی» برای افزودن کاربران به فهرست کاربران با قرار دادن برچسب از مرورگرها استفاده کنید. در سند «مطابقت کوکی» بیشتر ببینید
‫۱۲ اکتبر ۲۰۲۳ مقدار شمارشی RENDERING_PLAYABLE به CreativeAttribute اضافه شد.
‫۱۷ اوت ۲۰۲۳ ‫buyers.userLists.getRemarketingTag و UrlRestriction منسوخ شده‌اند و در تاریخ ۲۰۲۳/۱۰/۳۱ برچیده خواهند شد. از ویژگی google_ula برچسب «تطابق کوکی» برای افزودن کاربران به فهرست کاربر با قرار دادن برچسبی از مرورگرها استفاده کنید. در سند «مطابقت کوکی» بیشتر ببینید
۱۷ مارس ۲۰۲۳ فیلد missingCertificate به PolicyTopicEntry اضافه شد.
۷ فوریه ۲۰۲۳

مقادیر enum منسوخ‌شده زیر از 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
‫۸ نوامبر ۲۰۲۲

مقدار شمارشی 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
‫۲۰ سپتامبر ۲۰۲۲ فیلد آزمایشی creatives.renderUrl برای آزمایش‌های معرفی ویژگی جدید FLEDGE معرفی شد.
۱ سپتامبر ۲۰۲۲ وضعیت CERTIFICATE_REQUIRED را برای برخی‌از طرح‌آگهی‌ها معرفی کردیم. برای اطلاعات بیشتر، خط‌مشی قمار و بازی‌ها را ببینید.
‫۲۷ آوریل ۲۰۲۲ انتشار منبع publisherConnections. صرافی‌های «پیشنهاد قیمت باز» می‌توانند از publisherConnections برای مدیریت اتصالات با ناشران استفاده کنند.
‫۱ نوامبر ۲۰۲۱ معرفی bidders.enpoints.patch برای به‌روزرسانی نقطه پایانی پیشنهاددهنده.
‫۲۷ مه ۲۰۲۱ فیلد oneof video به منبع «آگهی‌های دارایی‌های بومی» معرفی شد که videoVastXml یا videoUrl را می‌پذیرد.
‫۸ اکتبر ۲۰۲۰ فیلدهای openAuctionServingStatus، openBiddingServingStatus، dealsServingStatus، chinaServingStatus و russiaServingStatus به‌ترتیب با networkPolicyCompliance، platformPolicyCompliance، dealsPolicyCompliance، chinaPolicyCompliance و russiaPolicyCompliance جایگزین شدند.
۲۴ ژوئن ۲۰۲۰ راه‌اندازی اولیه میانای برنامه‌سازی کاربردی مناقصه هم‌زمان، برای جایگزینی نهایی میانای برنامه‌سازی کاربردی خریدار Ad Exchange و خریدار Ad Exchange II.

قدیمی

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

تاریخ یادداشت‌ها
‫۲۰۲۵/۸/۱۱

وضعیت OVERDELIVERED_IMPRESSION به Status enum NonBillableWinningBidStatusRow اضافه شد.

۲۰۲۳/۹/۲۹

همه منابع به‌جز منابعی که برای «عیب‌یابی مناقصه هم‌زمان» استفاده می‌شوند منسوخ شده‌اند و درصورت فراخوانی، پاسخ خطا برمی‌گردانند. توصیه می‌کنیم به Marketplace API منتقل شوید تا همچنان بتوانید به‌صورت برنامه‌نویسی‌شده به Marketplace دسترسی داشته باشید. منابعی که منسوخ می‌شوند شامل موارد زیر و همه زیرمنابع آن‌ها است:

  • 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 اضافه شد.

۲۰۱۶/۳/۹

دسترسی کارخواه به‌عنوان نسخه بتای عمومی منتشر شد. اکنون می‌توانید به خریداران مشتری‌تان اجازه دهید مستقیماً به «بازار خریداران مجاز» دسترسی داشته باشند تا بتوانند معامله‌ها را مشاهده، مذاکره، و تأیید کنند. و برنامه‌تان می‌تواند به‌صورت برنامه‌نویسی‌شده عملیاتی را انجام دهد که قبلاً باید به‌صورت دستی در بخش مشتریان برگه تنظیمات حساب خریدار Authorized Buyers انجام می‌شد.