Method: exchanges.generateReport

रिपोर्ट आईडी जनरेट करता है और उसे दिखाता है. रिपोर्ट सेव नहीं की जाती. एक ही अनुरोध के साथ किए गए कॉल से, रिपोर्ट फिर से जनरेट होगी.

एचटीटीपी अनुरोध

POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
exchange

string

ज़रूरी है. उस एक्सचेंज का नाम जिससे रिपोर्ट जुड़ी है. उदाहरण के लिए: "exchanges/123" ज़रूरी है.

अनुरोध का मुख्य हिस्सा

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
फ़ील्ड
startDate

string

ज़रूरी है. रिपोर्ट की शुरू होने की तारीख, ISO_8601 फ़ॉर्मैट YYYY-MM-DD में होनी चाहिए. इसमें शुरू होने की तारीख भी शामिल है. इनपुट के तौर पर ज़रूरी है.

endDate

string

ज़रूरी है. रिपोर्ट की खत्म होने की तारीख, ISO_8601 फ़ॉर्मैट YYYY-MM-DD में होनी चाहिए. इसमें खत्म होने की तारीख भी शामिल है. इनपुट के तौर पर ज़रूरी है.

reportType

enum (ReportType)

ज़रूरी है. रिपोर्ट का टाइप. अगर यह जानकारी नहीं दी जाती है, तो गड़बड़ियां दिखेंगी.

dimensionIds[]

enum (DimensionId)

ज़रूरी नहीं. डाइमेंशन की सूची, जिसके आधार पर रिपोर्ट जनरेट की जाएगी. अगर यह सूची खाली है, तो सिर्फ़ पब्लिशर आईडी शामिल करें. अगर किसी खास तरह की रिपोर्ट में डाइमेंशन काम नहीं करते हैं, तो उन्हें अनदेखा कर दिया जाएगा.

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में 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 पब्लिशर आईडी. अगर इनपुट डाइमेंशन आईडी की सूची खाली है, तो यह डिफ़ॉल्ट डाइमेंशन होता है.