הערות מוצר

Marketplace API

גירסה 1.0

תאריך הערות
‫14 בדצמבר 2025
  • השדה accountID במשאב mediaPlanners הוצא משימוש.
‫10 בנובמבר 2025
‫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 הוספנו את ערך ה-enum‏ AUDIO אל CreativeFormat. נוסף ערך ה-enum‏ LG_TV אל AppStoreType.
‫11 באוקטובר 2021 השקה ראשונית של Authorized Buyers Marketplace API, שמאפשר לכם:
  • הצעת עסקאות וניהול משא ומתן עם בעלי תוכן דיגיטלי
  • אחזור של דילים סופיים ומדדי תקינות של דילים
  • ניהול מינויים לחבילות מכרזים
  • ניהול לקוחות ומשתמשים של לקוחות
  • איך מוצאים פרופילים של בעלי תוכן דיגיטלי

גרסת בטא 1.0

תאריך הערות
‫29 ביוני 2026
‫14 בדצמבר 2025
  • המשאבים curatedPackages ו-mediaPlanners זמינים עכשיו לאוצרים בגרסה 1beta.
  • השדה accountID במשאב mediaPlanners הוצא משימוש.
‫11 ביוני 2025
  • השקנו את גרסה v1beta של ה-API.
  • המשאב dataSegments זמין עכשיו בגרסה v1beta.
    • נתיב המשאב של dataSegments השתנה מ-buyers/{accountId}/dataSegments בגרסה v1alpha ל-curators/{accountId}/dataSegments בגרסה v1beta

גרסה 1.0 אלפא

תאריך הערות
‫29 ביוני 2026
‫14 בדצמבר 2025
  • המשאבים curatedPackages ו-mediaPlanners זמינים עכשיו לאוצרים בגרסה v1alpha.
  • השדה accountID במשאב mediaPlanners הוצא משימוש.
‫12 ביוני 2024
  • הגרסה הראשונה של v1alpha API.

Real-time Bidding API

גירסה 1.0

תאריך הערות
‫1 במאי 2025 הערך GOOGLE_RTB הוצא משימוש במרחב enum של BidProtocol.
‫24 בפברואר 2025 נוסף ערך חדש GOOGLE_AD_CATEGORY_TAXONOMY ל-enum space של AdCategoryTaxonomy.
‫13 בפברואר 2025 קטגוריות מוגבלות מוצהרות שהוצאו משימוש ב קריאייטיב.
‫6 באוגוסט 2024
‫30 ביולי 2024
‫31 באוקטובר 2023 הפונקציות buyers.userLists.getRemarketingTag ו-UrlRestriction הוצאו משימוש, ואם תתבצע קריאה שלהן, תוחזר תגובת שגיאה. מומלץ להשתמש בתכונה google_ula של תג Cookie Matching כדי להוסיף משתמשים לרשימת משתמשים באמצעות הצבת תג מהדפדפנים. מידע נוסף מופיע ב מאמרי העזרה בנושא התאמות של קובצי Cookie
‫12 באוקטובר 2023 נוסף ערך ה-enum‏ RENDERING_PLAYABLE אל CreativeAttribute.
‫17 באוגוסט 2023 השיטות buyers.userLists.getRemarketingTag ו-UrlRestriction הוצאו משימוש והן יבוטלו ב-31/10/2023. משתמשים בתכונה google_ula של תג Cookie Matching כדי להוסיף משתמשים לרשימת משתמשים על ידי הצבת תג מהדפדפנים. מידע נוסף מופיע ב מאמרי העזרה בנושא התאמות של קובצי Cookie
‫17 במרץ 2023 הוספנו את השדה missingCertificate אל PolicyTopicEntry.
‫7 בפברואר 2023

הוסרו ערכי ה-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
‫8 בנובמבר 2022

נוסף ערך enum חדש OPENRTB_PROTOBUF עבור bidders.endpoints.bidProtocol. מעכשיו, תהיה תמיכה רק בגרסה אחת של OpenRTB בכל פעם. כדי להשתמש בגרסה העדכנית ביותר של OpenRTB שנתמכת בפורמט המועדף עליכם, צריך להשתמש ב-OPENRTB_JSON או ב-OpenRTB_PROTOBUF. פרטים נוספים זמינים בפוסט בבלוג בנושא הסרת התמיכה בגרסאות ישנות של OpenRTB.

השדות הבאים של 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
20 בספטמבר 2022 הוספנו את השדה creatives.renderUrl לגרסאות המקור לניסיון של FLEDGE.
1 בספטמבר 2022 הוספנו את הסטטוס CERTIFICATE_REQUIRED לחלק מהנכסים הקריאייטיביים. מידע נוסף זמין במדיניות בנושא הימורים ומשחקים.
27 באפריל 2022 הפצת המשאב publisherConnections. בורסות Open Bidding יכולות להשתמש ב-publisherConnections כדי לנהל את החיבורים עם בעלי האתרים.
‫1 בנובמבר 2021 הוספנו את bidders.enpoints.patch כדי לעדכן את נקודת הקצה של משתתף בהצעת מחיר.
27 במאי 2021 הוספנו שדה oneof‏ video למשאב Native Creatives, שמקבל את הערכים videoVastXml או videoUrl.
‫8 באוקטובר 2020 השדות openAuctionServingStatus, ‏ openBiddingServingStatus,‏ dealsServingStatus, ‏ chinaServingStatus ו-russiaServingStatus הוחלפו בשדות networkPolicyCompliance,‏ platformPolicyCompliance, ‏ dealsPolicyCompliance,‏ chinaPolicyCompliance ו-russiaPolicyCompliance בהתאמה.
24 ביוני 2020 השקה ראשונית של API לבידינג בזמן אמת, שנועד להחליף בסופו של דבר את ממשקי ה-API של Ad Exchange Buyer ו-Ad Exchange Buyer II.

דור קודם

גרסה 2.0 (יצאה משימוש)

תאריך הערות
8/11/2025

הוספנו את הסטטוס OVERDELIVERED_IMPRESSION ל-enum‏ Status של NonBillableWinningBidStatusRow.

29.09.2023

כל המשאבים האחרים, מלבד אלה שמשמשים לפתרון בעיות ב-RTB, הוצאו משימוש ויחזירו תגובת שגיאה אם תתבצע אליהם קריאה. מומלץ לעבור ל-Marketplace API כדי להמשיך לגשת ל-Marketplace באופן פרוגרמטי. משאבים שהוצאו משימוש כוללים את המשאבים הבאים ואת כל משאבי המשנה שלהם:

  • accounts.clients
  • accounts.creatives
  • accounts.finalizedProposals
  • accounts.products
  • accounts.proposals
  • accounts.publisherProfiles
  • accounts.clients
24/05/2021

נוספו methods ברמת העסקה pause ו-resume

20/8/2020

השדה detail נוסף לBidMetricsRow.

06/05/2020

השדה reachedQueries נוסף ל-BidMetricsRow. נוספו הערכים FATAL_VAST_ERROR ו-LOST_IN_MEDIATION לרשימת הערכים Status של NonBillableWinningBidStatusRow.

09/03/2016

השקנו את הגישה ללקוח כגרסת בטא פתוחה. עכשיו אתם יכולים לאפשר לקונים הלקוחות שלכם גישה ישירה ל-Authorized Buyers Marketplace כדי שיוכלו לראות עסקאות, לנהל משא ומתן ולאשר אותן. בנוסף, האפליקציה יכולה לבצע באופן פרוגרמטי פעולות שבעבר היה צריך לבצע באופן ידני בקטע לקוחות בכרטיסייה הגדרות חשבון קונה ב-Authorized Buyers.