- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- ReportType
- DimensionId
रिपोर्ट आईडी जनरेट करता है और उसे दिखाता है. रिपोर्ट सेव नहीं की जाती. एक ही अनुरोध के साथ किए गए कॉल से, रिपोर्ट फिर से जनरेट होगी.
एचटीटीपी अनुरोध
POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport
यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
| पैरामीटर | |
|---|---|
exchange |
ज़रूरी है. उस एक्सचेंज का नाम जिससे रिपोर्ट जुड़ी है. उदाहरण के लिए: "exchanges/123" ज़रूरी है. |
अनुरोध का मुख्य हिस्सा
अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:
| JSON के काेड में दिखाना |
|---|
{ "startDate": string, "endDate": string, "reportType": enum ( |
| फ़ील्ड | |
|---|---|
startDate |
ज़रूरी है. रिपोर्ट की शुरू होने की तारीख, ISO_8601 फ़ॉर्मैट YYYY-MM-DD में होनी चाहिए. इसमें शुरू होने की तारीख भी शामिल है. इनपुट के तौर पर ज़रूरी है. |
endDate |
ज़रूरी है. रिपोर्ट की खत्म होने की तारीख, ISO_8601 फ़ॉर्मैट YYYY-MM-DD में होनी चाहिए. इसमें खत्म होने की तारीख भी शामिल है. इनपुट के तौर पर ज़रूरी है. |
reportType |
ज़रूरी है. रिपोर्ट का टाइप. अगर यह जानकारी नहीं दी जाती है, तो गड़बड़ियां दिखेंगी. |
dimensionIds[] |
ज़रूरी नहीं. डाइमेंशन की सूची, जिसके आधार पर रिपोर्ट जनरेट की जाएगी. अगर यह सूची खाली है, तो सिर्फ़ पब्लिशर आईडी शामिल करें. अगर किसी खास तरह की रिपोर्ट में डाइमेंशन काम नहीं करते हैं, तो उन्हें अनदेखा कर दिया जाएगा. |
जवाब का मुख्य हिस्सा
कामयाब रहने पर, जवाब के मुख्य हिस्से में Report का एक इंस्टेंस शामिल किया जाता है.
अनुमति पाने के लिंक
नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:
https://www.googleapis.com/auth/doubleclickbidmanager
ज़्यादा जानकारी के लिए, देखें OAuth 2.0 Overview.
ReportType
रिपोर्ट का टाइप.
| Enums | |
|---|---|
REPORT_TYPE_UNSPECIFIED |
रिपोर्ट का टाइप तय नहीं किया गया है. यह इनपुट वैल्यू अमान्य है. |
HOURLY |
हर घंटे की रिपोर्ट का टाइप. |
DAILY |
हर दिन की रिपोर्ट का टाइप. |
WEEKLY |
हर हफ़्ते की रिपोर्ट का टाइप. |
MONTHLY |
हर महीने की रिपोर्ट का टाइप. |
AWBID_DAILY |
AwBid की हर दिन की रिपोर्ट का टाइप. |
AWBID_WEEKLY |
AwBid की हर हफ़्ते की रिपोर्ट का टाइप. |
AWBID_MONTHLY |
AwBid की हर महीने की रिपोर्ट का टाइप. |
AWBID_OUT_OF_MONTH_IVT |
AwBid की हर महीने की IVT रिपोर्ट का टाइप. |
DimensionId
रिपोर्ट का डाइमेंशन आईडी enum.
| Enums | |
|---|---|
DIMENSION_ID_UNSPECIFIED |
रिपोर्ट का डाइमेंशन तय नहीं किया गया है. यह इनपुट वैल्यू अमान्य है. |
PARTNER_ID |
पार्टनर आईडी. यह सिर्फ़ हर दिन की रिपोर्ट में काम करता है. |
DEVICE_TYPE |
डिवाइस का टाइप. यह सिर्फ़ हर दिन की रिपोर्ट में काम करता है. |
CREATIVE_ID |
क्रिएटिव आईडी. यह सिर्फ़ हर दिन की रिपोर्ट में काम करता है. कृपया ध्यान दें कि इस डाइमेंशन की वजह से, रिपोर्ट की फ़ाइल का साइज़ काफ़ी बढ़ सकता है. साथ ही, इस डाइमेंशन वाली रिपोर्ट को जनरेट होने में कई घंटे लग सकते हैं. हम आने वाले समय में, ज़्यादा लोड वाले इन फ़ील्ड पर रेटिंग की सीमा तय करेंगे. |
CREATIVE_TYPE |
क्रिएटिव टाइप, सिर्फ़ हर दिन की रिपोर्ट में काम करता है. कृपया ध्यान दें कि इस डाइमेंशन की वजह से, रिपोर्ट की फ़ाइल का साइज़ काफ़ी बढ़ सकता है. साथ ही, इस डाइमेंशन वाली रिपोर्ट को जनरेट होने में कई घंटे लग सकते हैं. हम आने वाले समय में, ज़्यादा लोड वाले इन फ़ील्ड पर रेटिंग की सीमा तय करेंगे. |
REGION_CODE |
देश/इलाके का कोड. यह सिर्फ़ हर दिन की रिपोर्ट में काम करता है. |
DEAL_ID |
डील आईडी. यह इन्वेंट्री सोर्स से मैप होता है और सिर्फ़ हर दिन की रिपोर्ट में काम करता है. |
PUBLISHER_ID |
पब्लिशर आईडी. अगर इनपुट डाइमेंशन आईडी की सूची खाली है, तो यह डिफ़ॉल्ट डाइमेंशन होता है. |