रिलीज़ टिप्पणियां

इस पेज पर, Google Bid Manager API के रिलीज़ नोट दिए गए हैं.

एपीआई का नया वर्शन: v2

22 सितंबर, 2025

ज्ञात समस्याएं

Display & Video 360 सहायता केंद्र में पहले ही बताया जा चुका है कि कम इस्तेमाल की वजह से, तीन Filter enum वैल्यू बंद की जा रही हैं.

v2

• नीचे दी गई Filters बंद कर दी गई हैं:

  Filter वैल्यू
  FILTER_DFP_ORDER_ID FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

1 मार्च, 2025

ज्ञात समस्याएं

YouTube TrueView इन्वेंट्री की उपलब्धता की रिपोर्ट और उससे जुड़े डाइमेंशन को बंद किया जा रहा है. इसके बारे में, Display & Video 360 के सहायता केंद्र में पहले ही सूचना दी जा चुकी है.

v2

• इन enum वैल्यू को बंद कर दिया गया है:

  Enum	वैल्यू
  ReportType	INVENTORY_AVAILABILITY

• इन फ़िल्टर को बंद कर दिया गया है:

  फ़िल्टर वैल्यू

  FILTER_DETAILED_DEMOGRAPHICS FILTER_DETAILED_DEMOGRAPHICS_ID FILTER_HOUSEHOLD_INCOME FILTER_LIFE_EVENT FILTER_REMARKETING_LIST FILTER_TRUEVIEW_IAR_AGE FILTER_TRUEVIEW_IAR_CATEGORY FILTER_TRUEVIEW_IAR_CITY FILTER_TRUEVIEW_IAR_COUNTRY FILTER_TRUEVIEW_IAR_COUNTRY_NAME FILTER_TRUEVIEW_IAR_GENDER FILTER_TRUEVIEW_IAR_INTEREST FILTER_TRUEVIEW_IAR_LANGUAGE FILTER_TRUEVIEW_IAR_PARENTAL_STATUS FILTER_TRUEVIEW_IAR_REGION_NAME FILTER_TRUEVIEW_IAR_REMARKETING_LIST FILTER_TRUEVIEW_IAR_TIME_OF_DAY FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO FILTER_TRUEVIEW_IAR_ZIPCODE FILTER_YOUTUBE_CHANNEL FILTER_YOUTUBE_VIDEO

• इन मेट्रिक को बंद कर दिया गया है:

  मेट्रिक की वैल्यू
  METRIC_POTENTIAL_VIEWS METRIC_TEA_TRUEVIEW_IMPRESSIONS METRIC_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

पहचान छिपाकर इन्वेंट्री मॉडलिंग (एआईएम) की रिपोर्टिंग डाइमेंशन की सुविधा बंद होना

FILTER_ANONYMOUS_INVENTORY_MODELING डाइमेंशन सूर्यास्त है.

params.groupBy में, बंद हो चुकी वैल्यू का इस्तेमाल करके Query संसाधन बनाने या चलाने पर, 400 गड़बड़ी दिखती है.

डीएसटी/आरओसी (रेगुलेटरी ऑपरेटिंग शुल्क) और कुल मीडिया लागत मेट्रिक, YOUTUBE रिपोर्ट के साथ काम नहीं करती हैं.

YOUTUBE रिपोर्ट में, मेट्रिक की इन वैल्यू का इस्तेमाल अब नहीं किया जा सकता:

• METRIC_TOTAL_MEDIACOST_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPC_USD
• METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPV_USD
• METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPA_USD
• METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPCV_USD
• METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPC_USD
• METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPM_USD
• METRIC_TOTAL_MEDIACOST_PARTNER
• METRIC_TOTAL_MEDIACOST_USD
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
• METRIC_FEE32_ADVERTISER
• METRIC_FEE32_PARTNER
• METRIC_FEE32_USD

Query संसाधन बनाते या चलाते समय, YOUTUBE में params.type और params.metrics में काम की मेट्रिक वैल्यू डालने पर, 400 गड़बड़ी दिखती है.

1 मई, 2024

नई सुविधाएं

कोई नहीं.

ज्ञात समस्याएं

v2

फ़ुल पाथ और पाथ एट्रिब्यूशन रिपोर्ट बंद होना

फ़ुल पाथ और पाथ एट्रिब्यूशन रिपोर्ट बंद कर दी गई हैं. इस तरह के Query और Report संसाधनों को वापस पाने या बनाने पर गड़बड़ी होती है.

ReportType की ये वैल्यू अब काम नहीं करेंगी:

• FULL_PATH
• PATH_ATTRIBUTION

Options ऑब्जेक्ट का pathQueryOptions फ़ील्ड भी बंद कर दिया गया है.

28 फ़रवरी, 2024

नई सुविधाएं

कोई नहीं.

ज्ञात समस्याएं

v2

क्रॉस-डिवाइस कन्वर्ज़न मेट्रिक वैल्यू बंद होना

क्रॉस-डिवाइस कन्वर्ज़न की मेट्रिक अब उपलब्ध नहीं हैं. इसमें Bid Manager API की ये मेट्रिक वैल्यू शामिल हैं:

• METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
• METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
• METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 जुलाई, 2022

नई सुविधाएं

Bid Manager API v2 रिलीज़ किया गया.

एपीआई में स्ट्रक्चरल बदलाव किए गए हैं. इनमें सेवा के एंडपॉइंट को अपडेट करना और सेवाओं और तरीकों के नाम बदलना शामिल है.

क्वेरी और रिपोर्ट के संसाधनों को काफ़ी हद तक अपडेट किया गया है. इसके लिए, गैर-ज़रूरी फ़ील्ड हटाए गए हैं, मौजूदा फ़ील्ड को फिर से व्यवस्थित किया गया है, और फ़ील्ड के टाइप बदले गए हैं. इसमें फ़ील्ड के टाइप को बदलकर, "नेस्ट किया गया ऑब्जेक्ट" की सामान्य परिभाषा के बजाय, नाम वाले ऑब्जेक्ट का इस्तेमाल करना शामिल है.

विज्ञापन से जुड़ी क्वेरी को queries.run तरीके का इस्तेमाल करके मैन्युअल तरीके से चलाना ज़रूरी है. ऐसा इसलिए, ताकि क्वेरी बनाने के बाद वे अपने-आप न चलें.

क्वेरी पैरामीटर asynchronous को queries.run से बदलकर synchronous कर दिया गया है.

इन बदलावों की मदद से, रिपोर्ट को आसानी से वापस पाया जा सकता है:

• queries.reports.get तरीका जोड़ा गया है.
• queries.reports.list में orderBy क्वेरी पैरामीटर जोड़ा गया है.
• queries.run रिस्पॉन्स बॉडी को खाली ऑब्जेक्ट से जनरेट किए गए Report संसाधन के इंस्टेंस में अपडेट किया गया.

एपीआई से मिलने वाले गड़बड़ी के मैसेज को अपडेट किया गया है, ताकि वे ज़्यादा सटीक हों और समस्याओं को ठीक करने के लिए ज़्यादा जानकारी दें.

v1.1 से v2 पर माइग्रेट करने के लिए, v2 माइग्रेशन गाइड में दिए गए निर्देशों का पालन करें.

v2

• सेवा के एंडपॉइंट में बदलाव किया गया है:

  v1 सेवा का एंडपॉइंट	v2 सेवा का एंडपॉइंट
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• सेवाओं के नाम इस तरह बदले गए हैं:

  v1 सेवा	v2 सेवा
  क्वेरी	queries
  रिपोर्ट	queries.reports

• तरीकों के नाम बदलकर ये कर दिए गए हैं:

  v1 तरीका	v2 तरीका
  Queries.createquery	queries.create
  Queries.deletequery	queries.delete
  Queries.getquery	queries.get
  Queries.listqueries	queries.list
  Queries.runquery	queries.run
  Reports.listreports	queries.reports.list

• ये तरीके जोड़े गए हैं:

  सेवा	तरीका
  queries.reports	पाएं

• इन तरीकों के लिए, रिस्पॉन्स का नया मुख्य हिस्सा उपलब्ध है:

  तरीका	जवाब के मुख्य हिस्से का नया ऑब्जेक्ट
  queries.run	शिकायत करें

• इन फ़ील्ड को हटा दिया गया है:

  संसाधन	फ़ील्ड
  queries.list जवाब का मुख्य हिस्सा	टाइप
  queries.reports.list जवाब का मुख्य हिस्सा	टाइप
  क्वेरी	टाइप reportDataEndTimeMs reportDataStartTimeMs timezoneCode
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs timezoneCode

• इन फ़ील्ड के ऑब्जेक्ट टाइप को बदलकर यह कर दिया गया है:

  संसाधन	फ़ील्ड	ऑब्जेक्ट टाइप
  क्वेरी	metadata params schedule	QueryMetadata पैरामीटर QuerySchedule
  शिकायत करें	key metadata params	ReportKey ReportMetadata पैरामीटर
  RunQueryRequest	dataRange	DataRange

• क्वेरी के लिए ये पैरामीटर जोड़े गए हैं:

  तरीका	क्वेरी पैरामीटर
  queries.list	orderBy
  queries.reports.list	orderBy
  queries.run	synchronous

• क्वेरी पैरामीटर के तौर पर इस्तेमाल किए जाने वाले इन तरीकों को हटा दिया गया है:

  तरीका	क्वेरी पैरामीटर
  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 की पिछली रिलीज़ के बारे में जानने के लिए, संग्रहित किए गए रिलीज़ नोट देखें.