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

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 API.
  • منبع 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

تاریخ یادداشت‌ها
‫۱۰ نوامبر ۲۰۲۶ پارامتر پُرسمان adCategoryTaxonomyOverride را به روش‌های buyers.creatives.get، buyers.creatives.list، و bidders.creatives.list معرفی کردیم تا پیشنهاددهندگان بتوانند AdCategoryTaxonomy استفاده‌شده در پاسخ را لغو کنند. مقدار شمارشی IAB_CONTENT_2_2 به AdCategoryTaxonomy اضافه شد. درحال‌حاضر، «طبقه‌بندی محتوای IAB نسخه ۲.۲» را نمی‌توان به‌عنوان طبقه‌بندی دسته آگهی برای حساب‌های «خریداران مجاز» یا «مناقصه باز» پیکربندی کرد.
‫۲۰ سپتامبر ۲۰۲۶ وضعیت 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 اضافه شد.

۲۰۲۳/۹/۲۹

همه منابع به‌جز منابعی که برای «عیب‌یابی RTB» استفاده می‌شوند منسوخ شده‌اند و درصورت فراخوانی، پاسخ خطا برمی‌گردانند. توصیه می‌کنیم به 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 از NonBillableWinningBidStatusRow اضافه شد.

۲۰۱۶/۳/۹

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