בדף הזה מפורטים נתוני הגרסה של Google Bid Manager API.
הגרסה האחרונה של ה-API: v2
22 בספטמבר 2025
בעיות מוכרות
הוצאנו משימוש שלושה ערכי enum (Filter) בגלל שימוש נמוך, כפי שפורסם בעבר במרכז העזרה של Display & Video 360.
v2
התכונות הבאות
Filtersיצאו משימוש:ערך אחד או יותר של FilterFILTER_DFP_ORDER_IDFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDERFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER
1 במרץ 2025
בעיות מוכרות
הוצאנו משימוש את הדוח 'זמינות מלאי שטחי פרסום ב-YouTube TrueView' ואת המאפיינים שקשורים אליו, כפי שפורסם בעבר במרכז העזרה של Display & Video 360.
v2
הערכים הבאים של enum הוצאו משימוש:
ספירה ערכים ReportTypeINVENTORY_AVAILABILITYהמסננים הבאים הוצאו משימוש:
ערכי סינון FILTER_DETAILED_DEMOGRAPHICSFILTER_DETAILED_DEMOGRAPHICS_IDFILTER_HOUSEHOLD_INCOMEFILTER_LIFE_EVENTFILTER_REMARKETING_LISTFILTER_TRUEVIEW_IAR_AGEFILTER_TRUEVIEW_IAR_CATEGORYFILTER_TRUEVIEW_IAR_CITYFILTER_TRUEVIEW_IAR_COUNTRYFILTER_TRUEVIEW_IAR_COUNTRY_NAMEFILTER_TRUEVIEW_IAR_GENDERFILTER_TRUEVIEW_IAR_INTERESTFILTER_TRUEVIEW_IAR_LANGUAGEFILTER_TRUEVIEW_IAR_PARENTAL_STATUSFILTER_TRUEVIEW_IAR_REGION_NAMEFILTER_TRUEVIEW_IAR_REMARKETING_LISTFILTER_TRUEVIEW_IAR_TIME_OF_DAYFILTER_TRUEVIEW_IAR_YOUTUBE_CHANNELFILTER_TRUEVIEW_IAR_YOUTUBE_VIDEOFILTER_TRUEVIEW_IAR_ZIPCODEFILTER_YOUTUBE_CHANNELFILTER_YOUTUBE_VIDEOהוצאנו משימוש את המדדים הבאים:
ערכי מדדים METRIC_POTENTIAL_VIEWSMETRIC_TEA_TRUEVIEW_IMPRESSIONSMETRIC_TEA_TRUEVIEW_UNIQUE_COOKIES
20 בנובמבר 2024
תכונות חדשות
האפליקציה FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID מופעלת. כך אפשר לכלול נתונים ברמת מהימנות נמוכה יותר למדדים עם הקידומות הבאות:
METRIC_UNIQUE_REACH_METRIC_VIRTUAL_PEOPLE_DUPLICATE_METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_METRIC_VIRTUAL_PEOPLE_OVERLAP_
כשמשתמשים במסנן הזה, צריך לכלול אחד מהמדדים הרלוונטיים.
עם ההשקה, שאילתות שלא כוללות את המסנן הזה יחזרו להתנהגות ברירת המחדל הקודמת, שכוללת רק נתונים ברמת מהימנות גבוהה. החל מ-4 בפברואר 2025, שאילתות שלא כוללות את המסנן הזה יכללו כברירת מחדל נתונים עם רמת מהימנות נמוכה יותר.
v2
המסננים הבאים נוספו:
סוג מסנן ערכים זמינים FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
0: הכללת נתונים עם רמת מהימנות נמוכה יותר. (ברירת המחדל אחרי 4 בפברואר 2025)1: רק נתונים ברמת מהימנות גבוהה. (ברירת המחדל לפני 4 בפברואר 2025)
1 באוקטובר 2024
תכונות חדשות
ללא.
בעיות מוכרות
v2
הוצאה משימוש של מאפיין הדיווח 'יצירת מודלים של מלאי אנונימי (AIM)'
המאפיין FILTER_ANONYMOUS_INVENTORY_MODELING הוא שקיעה.
יצירה או הפעלה של משאבי Query באמצעות ערכים שהוצאו משימוש ב-params.groupBy מחזירה שגיאת 400.
המדדים 'מס שירותים דיגיטליים (DST) / עלויות תפעול רגולטוריות (ROC)' ו'עלות מדיה כוללת' לא תואמים יותר לדוחות YOUTUBE.
אי אפשר יותר להשתמש בערכי המדדים הבאים בדוחות YOUTUBE:
METRIC_TOTAL_MEDIACOST_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPC_USDMETRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPV_USDMETRIC_TOTAL_MEDIACOST_ECPA_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPA_PARTNERMETRIC_TOTAL_MEDIACOST_ECPA_USDMETRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPCV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPCV_USDMETRIC_TOTAL_MEDIACOST_ECPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPC_USDMETRIC_TOTAL_MEDIACOST_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_ECPM_USDMETRIC_TOTAL_MEDIACOST_PARTNERMETRIC_TOTAL_MEDIACOST_USDMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USDMETRIC_FEE32_ADVERTISERMETRIC_FEE32_PARTNERMETRIC_FEE32_USD
יצירה או הפעלה של משאבי Query עם params.type של YOUTUBE וערך מדד רלוונטי ב-params.metrics מחזירה שגיאת 400.
1 במאי 2024
תכונות חדשות
ללא.
בעיות מוכרות
v2
הוצאה משימוש של הדוחות 'נתיב מלא' ו'שיוך לנתיב'
הוצאנו משימוש את הדוחות 'נתיב מלא' ו'שיוך לנתיב'. אחזור או יצירה של משאבי Query ו-Report מהסוגים האלה יובילו לשגיאה.
הערכים הבאים של ReportType יצאו משימוש:
FULL_PATHPATH_ATTRIBUTION
גם השדה pathQueryOptions של האובייקט Options יצא משימוש.
28 בפברואר 2024
תכונות חדשות
ללא.
בעיות מוכרות
v2
הוצאה משימוש של ערכי המדדים של המרות חוצות-מכשירים
הוצאנו משימוש את מדדי ההמרות חוצות-המכשירים. הדוח כולל את ערכי המדדים הבאים של Bid Manager API:
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENTMETRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENTMETRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT
6 ביולי 2022
תכונות חדשות
השקנו את גרסה 2 של Bid Manager API.
בוצעו שינויים מבניים ב-API, כולל עדכון של נקודת הקצה של השירות ושינוי השם של שירותים ושיטות.
עדכנו באופן משמעותי את מקורות המידע Query ו-Report. השינויים כוללים הסרה של שדות מיותרים, ארגון מחדש של שדות קיימים ושינוי של סוגי שדות. השינויים כוללים שינוי של סוגי שדות לשימוש באובייקטים עם שם במקום בהגדרה כללית של 'אובייקט מקונן'.
חובה להריץ שאילתות אד-הוק באמצעות השיטה queries.run במקום להריץ אותן באופן אוטומטי אחרי היצירה.
פרמטר השאילתה queries.run asynchronous הוחלף בפרמטר synchronous.
פישוט של אחזור הדוחות באמצעות השינויים הבאים:
- הוספה של אמצעי תשלום מסוג
queries.reports.get. - הוספה של פרמטר השאילתה
orderByאלqueries.reports.list. - העדכון של גוף התגובה
queries.runמאובייקט ריק למופע של משאבReportשנוצר.
עדכנו את הודעות השגיאה שמוחזרות על ידי ה-API כדי שיהיו ספציפיות יותר ויספקו פתרונות מפורטים יותר.
כדי לעבור מגרסה 1.1 לגרסה 2, פועלים לפי ההוראות שמפורטות במדריך להעברה לגרסה 2.
v2
נקודת הקצה של השירות השתנתה:
נקודת קצה של שירות בגרסה 1 נקודת קצה של שירות גרסה 2 https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.comהשמות של השירותים השתנו באופן הבא:
שירות v1 שירות v2 שאילתות שאילתות דוחות queries.reports השמות של ה-methods השתנו באופן הבא:
השיטות הבאות נוספו:
שירות שיטות queries.reports get לשיטות הבאות יש גוף תשובה חדש:
שיטה אובייקט חדש של גוף התשובה queries.run אפשר לדווח עליו כאן השדות הבאים הוסרו:
משאב שדות queries.listResponse Bodyסיווג
queries.reports.listResponse Bodyסיווג
שאילתה סיווג
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
סוג האובייקט של השדות הבאים השתנה:
משאב שדות סוג אובייקט שאילתה אפשר לדווח עליו כאן RunQueryRequest הוספנו את פרמטרים השאילתה של השיטה הבאים:
שיטה פרמטרים של שאילתה queries.list orderBy queries.reports.list orderBy queries.run סינכרוני הפרמטרים הבאים של שאילתות שיטות הוסרו:
שיטה פרמטרים של שאילתה queries.create אסינכרוני queries.run אסינכרוני הערכים הבאים של המסנן נוספו:
ערך המסנן FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION הערכים הבאים של המסנן הוסרו:
ערך המסנן FILTER_TRUEVIEW_IAR_REGION הוספנו את הערכים הבאים של מדדים:
ערך המדד METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
בעיות מוכרות
ללא.
גרסאות קודמות
כדי לקרוא על גרסאות קודמות של Bid Manager API שהוצאו משימוש, אפשר לעיין בנתוני הגרסה בארכיון.