הערות מוצר

Marketplace API

גירסה 1.0

תאריך	הערות
‫14 בדצמבר 2025	השדה accountID במשאב mediaPlanners הוצא משימוש.
‫10 בנובמבר 2025	הוספנו את השדה floorPriceCpm אל AuctionPackage. הוספנו תמיכה ברמת הבידר עבור setReadyToServe.
‫26 באוגוסט 2025	כשמתקשרים אל buyers.proposals.sendRfp, אפשר להשתמש בטירגוט לפי גודל מלאי רק לגדלים של מלאי שטחי פרסום מסוג PIXEL.
‫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. השדה 'מבצע' [Deal] billedBuyer לא יאוכלס אם הוא שייך לחשבון של מתכנן מדיה.
‫29 בנובמבר 2023	הוספנו את ערך ה-enum‏ AUDIO אל CreativeFormat. הוספנו את ערך ה-enum‏ LG_TV אל AppStoreType.
‫11 באוקטובר 2021	השקה ראשונית של Authorized Buyers Marketplace API, שמאפשר לכם: הצעת עסקאות וניהול משא ומתן עם בעלי תוכן דיגיטלי אחזור של דילים סופיים ומדדי תקינות של דילים ניהול מינויים לחבילות למכירות פומביות ניהול לקוחות ומשתמשים של לקוחות איך מוצאים פרופילים של בעלי תוכן דיגיטלי

גרסה 1.0 בטא

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

גרסה 1.0 אלפא

תאריך	הערות
‫25 באוגוסט 2026	הוספנו את השדה userListId אל DataSegment.
‫20 ביולי 2026	הוספנו את השדה curationFeeVisibility אל CuratedPackage.
‫29 ביוני 2026	הוספנו את השדה millipercentOfMediaFee אל DataSegment. הוספנו את השדה millipercentOfMediaFee אל CuratedPackage.
‫14 בדצמבר 2025	המשאבים curatedPackages ו-mediaPlanners זמינים עכשיו לאוצרים בגרסה 1 אלפא. השדה accountID במשאב mediaPlanners הוצא משימוש.
‫12 ביוני 2024	הגרסה הראשונה של v1alpha API.

Real-time Bidding API

גירסה 1.0

תאריך	הערות
‫20 בספטמבר 2026	הוצאנו משימוש את CERTIFICATE_REQUIRED status ואת missingCertificate field בעקבות עדכוני מדיניות שכבר לא מחייבים אישורים לפרסום הימורים ומשחקי קזינו חברתיים.
‫10 בספטמבר 2026	הוספנו את השיטה addDeals למשאב buyers.creatives, כדי לאפשר לקנייני מדיה לשייך מזהי דילים (כולל דילים פרוגרמטיים מובטחים, מכרזים פרטיים, דילים בלעדיים ללקוחות מועדפים וחבילות של זירת מסחר) לנכסי קריאייטיב.
‫9 ביולי 2026	הוצאנו משימוש את השדה allowed_user_targeting_modes ואת הערך enum‏ UserTargetingMode ב- PretargetingConfig.
‫1 במאי 2025	הערך GOOGLE_RTB הוצא משימוש במרחב ה-enum‏ BidProtocol.
‫24 בפברואר 2025	נוסף הערך החדש GOOGLE_AD_CATEGORY_TAXONOMY ל-enum AdCategoryTaxonomy.
‫13 בפברואר 2025	הוצאנו משימוש קטגוריות מוגבלות מוצהרות ב קריאייטיב.
‫6 באוגוסט 2024	הוספנו את השדות detectedCategoriesTaxonomy ו-detectedCategories ל-CreativeServingDecision.
‫30 ביולי 2024	הוספנו את הערך המספרי PUBLISHER_FIRST_PARTY_ID ל-PretargetingConfig.
‫31 באוקטובר 2023	הפונקציות buyers.userLists.getRemarketingTag ו-UrlRestriction הוצאו משימוש, ואם תתבצע קריאה שלהן תוחזר תגובת שגיאה. מומלץ להשתמש בתכונה google_ula של תג התאמה לקובצי Cookie כדי להוסיף משתמשים לרשימת משתמשים על ידי הצבת תג מהדפדפנים. מידע נוסף מופיע ב מאמרי העזרה בנושא התאמות של קובצי 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_JSON או ב-OpenRTB_PROTOBUF כדי להשתמש בגרסה העדכנית ביותר של OpenRTB בפורמט המועדף. פרטים נוספים זמינים בפוסט בבלוג בנושא הסרת התמיכה בגרסאות ישנות של 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, שנועד להחליף בסופו של דבר את Ad Exchange Buyer ו-Ad Exchange Buyer II APIs.

דור קודם

הוצאנו משימוש את Ad Exchange Buyer API II. כל המשאבים האחרים הוצאו משימוש ב-29 בספטמבר 2023, למעט המשאבים שמשמשים לפתרון בעיות ב-RTB. אם אתם רוצים להמשיך להשתמש ב-Marketplace, מומלץ לעבור ל-Marketplace API.

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

תאריך	הערות
8/11/2025	הוספנו את הסטטוס OVERDELIVERED_IMPRESSION ל-enum‏ Status של NonBillableWinningBidStatusRow.
29.09.2023	כל המשאבים האחרים, מלבד אלה שמשמשים לפתרון בעיות ב-RTB, הוצאו משימוש ויחזירו תגובת שגיאה אם תתבצע אליהם קריאה. כדי להמשיך לגשת לתוכנית Marketplace באופן פרוגרמטי, מומלץ לעבור ל-Marketplace API. משאבים שהוצאו משימוש כוללים את המשאבים הבאים ואת כל משאבי המשנה שלהם: accounts.clients accounts.creatives accounts.finalizedProposals accounts.products accounts.proposals accounts.publisherProfiles accounts.clients
24.05.2021	נוספו methods ברמת העסקה: pause ו-resume
8/20/2020	השדה detail נוסף ל-BidMetricsRow.
05/06/2020	השדה reachedQueries נוסף ל-BidMetricsRow. הוספנו את FATAL_VAST_ERROR ואת LOST_IN_MEDIATION לספירה Status של NonBillableWinningBidStatusRow.
09.03.2016	השקנו את Client Access כבטא פתוחה. מעכשיו אתם יכולים לאפשר ללקוחות שלכם, שהם קונים, גישה ישירה ל-Authorized Buyers Marketplace כדי שהם יוכלו לראות עסקאות, לנהל משא ומתן ולאשר אותן. בנוסף, האפליקציה יכולה לבצע באופן פרוגרמטי פעולות שבעבר היה צריך לבצע באופן ידני בקטע לקוחות בכרטיסייה הגדרות חשבון קונה ב-Authorized Buyers.