यह पेज Google Bid Manager API के रिलीज़ नोट्स उपलब्ध कराता है.
संस्करण 2
एपीआई में बुनियादी बदलाव किए गए. इनमें सेवा के एंडपॉइंट को अपडेट करना, सेवाओं के नाम बदलना, और तरीकों के नाम बदलना शामिल है.
ग़ैर-ज़रूरी फ़ील्ड को हटाकर, मौजूदा फ़ील्ड को फिर से व्यवस्थित करके, और फ़ील्ड टाइप को बदलकर, क्वेरी और रिपोर्ट रिसॉर्स को ज़रूरी तौर पर अपडेट किया गया. इसमें सामान्य "नेस्ट किए गए ऑब्जेक्ट" परिभाषा के बजाय नाम वाले ऑब्जेक्ट का इस्तेमाल करने के लिए, फ़ील्ड के टाइप में बदलाव करना शामिल है.
क्वेरी बनाए जाने के बाद अपने-आप चलने के बजाय, queries.run
तरीके का इस्तेमाल करके ऐड-हॉक क्वेरी को चलाना ज़रूरी है.
queries.run
क्वेरी पैरामीटर asynchronous
को
synchronous
से बदला गया.
नीचे दिए गए बदलावों के ज़रिए रिपोर्ट को आसानी से वापस पाना:
queries.reports.get
वाला तरीका जोड़ना.queries.reports.list
मेंorderBy
क्वेरी पैरामीटर को जोड़ा गया.- किसी खाली ऑब्जेक्ट से, जनरेट किए गए
Report
रिसॉर्स के इंस्टेंस में,queries.run
रिस्पॉन्स बॉडी का अपडेट.
एपीआई से मिले गड़बड़ी के मैसेज को ज़्यादा सटीक बनाने और ज़्यादा सटीक समाधान देने के लिए, अपडेट किए गए.
v1.1 से v2 पर माइग्रेट करने के लिए, v2 माइग्रेशन गाइड में दिए गए निर्देशों का पालन करें.
नई सुविधाएं
सेवा एंडपॉइंट बदल दिया गया है:
v1 सेवा एंडपॉइंट v2 सेवा एंडपॉइंट https://www.googleapis.com/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
सेवाओं के नाम इस तरह बदले गए हैं:
v1 सेवा v2 सेवा क्वेरी क्वेरी रिपोर्ट queries.reports तरीकों के नाम इस तरह बदले गए हैं:
ये तरीके जोड़े गए हैं:
सेवा तरीके queries.reports पाएं इन तरीकों में जवाब का नया मुख्य हिस्सा जोड़ा गया है:
तरीका जवाब का नया मुख्य ऑब्जेक्ट queries.run शिकायत करें इन फ़ील्ड को हटा दिया गया है:
संसाधन फ़ील्ड queries.list
जवाब का मुख्य हिस्सादयालु
queries.reports.list
जवाब का मुख्य हिस्सादयालु
क्वेरी दयालु
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
आम तौर पर होने वाली समस्याएं
कोई नहीं.
वर्शन 1.1
कॉलम मैपिंग की रिपोर्ट के लिए वन-टू-वन फ़िल्टर
जो फ़िल्टर कई रिपोर्ट कॉलम पर मैप किए गए थे वे अब सिर्फ़ एक कॉलम में मैप किए गए हैं.
उदाहरण के लिए, v1 में, FILTER_ADVERTISER
फ़िल्टर शामिल करने से एक रिपोर्ट मिलती है. इसमें "विज्ञापन देने वाले के आईडी" के साथ-साथ "विज्ञापन देने वाला" कॉलम भी होगा. v1.1 में, सभी रिपोर्ट कॉलम में अपने फ़िल्टर होते हैं. उदाहरण के लिए, एक नया फ़िल्टर FILTER_ADVERTISER_NAME
, "विज्ञापन देने वाले" को मैप करता है. रिपोर्ट में "विज्ञापन देने वाला
आईडी" और "विज्ञापन देने वाला", दोनों कॉलम देखने के लिए, FILTER_ADVERTISER
और
FILTER_ADVERTISER_NAME
दोनों फ़िल्टर को
Queries.createquery
अनुरोधों में शामिल करना होगा.
साफ़ तौर पर कहें, तो createquery
का अनुरोध:
{
...
"params": {
...
"groupBys": ["FILTER_ADVERTISER"],
"metrics": ["METRIC_IMPRESSIONS"],
...
}
...
}
v1 में इन हेडर वाली एक रिपोर्ट फ़ाइल जनरेट करता है:
Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions
और v1.1 में नीचे दिए गए हेडर:
Advertiser,Impressions
ऊपर दिए गए उदाहरण में, रिपोर्ट कॉलम पाने के लिए नीचे दिए गए v1 कोड का इस्तेमाल किया गया है:
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
को v1.1 में नीचे दिए गए तरीके की तरह बदलाव करना होगा (नोट फ़िल्टर का क्रम):
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER_NAME");
groupBys.add("FILTER_ADVERTISER");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_STATUS");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_CODE");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
मूल फ़िल्टर | जोड़े गए फ़िल्टर |
---|---|
FILTER_ADVERTISER |
FILTER_ADVERTISER_NAME FILTER_ADVERTISER_INTEGRATION_CODE FILTER_ADVERTISER_INTEGRATION_STATUS |
FILTER_AD_POSITION |
FILTER_AD_POSITION_NAME |
FILTER_CARRIER |
FILTER_CARRIER_NAME |
FILTER_CHANNEL_ID |
FILTER_CHANNEL_NAME |
FILTER_CITY |
FILTER_CITY_NAME |
FILTER_COMPANION_CREATIVE_ID |
FILTER_COMPANION_CREATIVE_NAME |
FILTER_DMA |
FILTER_DMA_NAME |
FILTER_INSERTION_ORDER |
FILTER_INSERTION_ORDER_NAME |
FILTER_PARTNER |
FILTER_PARTNER_NAME FILTER_PARTNER_STATUS |
FILTER_REGION |
FILTER_REGION_NAME |
FILTER_TRUEVIEW_DMA |
FILTER_TRUEVIEW_DMA_NAME |
FILTER_TRUEVIEW_IAR_REGION |
FILTER_TRUEVIEW_IAR_REGION_NAME |
FILTER_USER_LIST_FIRST_PARTY |
FILTER_USER_LIST_FIRST_PARTY_NAME |
FILTER_USER_LIST_THIRD_PARTY |
FILTER_USER_LIST_THIRD_PARTY_NAME |
पेजों को क्रम में लगाना
v1.1, Queries.listqueries
और
Reports.listreports
तरीकों में पेज नंबर जोड़ता है.
v1.1 में, इन तरीकों से मिले नतीजों की संख्या, जोड़े गए नए पैरामीटर pageSize
के बराबर होती है. अगर इसके बारे में नहीं बताया गया है, तो यह डिफ़ॉल्ट रूप से 100
पर सेट हो जाता है. जवाबों में हाल ही में जोड़ा गया एक nextPageToken
फ़ील्ड होता है. इसका इस्तेमाल, नतीजों का अगला सेट पाने के लिए किया जा सकता है. अगर नतीजे खत्म हो गए हैं, तो यह फ़ील्ड खाली है.
किसी खास क्वेरी से जुड़ी सभी रिपोर्ट वापस पाने के लिए, नीचे दिया गया v1 कोड:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
return reportListResponse.getReports();
}
}
को v1.1 में बताए गए तरीके से बदलाव करना होगा, ताकि सभी रिपोर्ट पाना जारी रखा जा सके:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
List<Report> reports = new ArrayList<>(reportListResponse.getReports());
while (reportListResponse.getNextPageToken() != null
&& reportListResponse.getNextPageToken().length() > 0) {
// Get next set of results, aka page.
reportListResponse =
service
.reports()
.listreports(queryId)
.setPageToken(reportListResponse.getNextPageToken())
.execute();
reports.addAll(reportListResponse.getReports());
}
return reports;
}
}
ज़्यादा जानकारी के लिए, Queries.listqueries
और
Reports.listreports
तरीके
दस्तावेज़ देखें.
आम तौर पर होने वाली समस्याएं
कोई नहीं.
संस्करण 1
यह इस एपीआई का शुरुआती वर्शन है.
आम तौर पर होने वाली समस्याएं
कोई नहीं.