तुरंत रिपोर्ट जनरेट करता है और वापस करता है. इसे अभी आज़माएं.
अनुरोध करें
एचटीटीपी अनुरोध
POST https://www.googleapis.com/doubleclicksearch/v2/reports/generate
अनुमति दें
इस अनुरोध के लिए नीचे दिए गए दायरे की अनुमति चाहिए:
दायरा |
---|
https://www.googleapis.com/auth/doubleclicksearch |
ज़्यादा जानकारी के लिए, पुष्टि और अनुमति देना पेज देखें.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर में डेटा की जानकारी दें:
{ "reportScope": { "agencyId": long, "advertiserId": long, "engineAccountId": long, "campaignId": long, "adGroupId": long, "keywordId": long, "adId": long }, "reportType": string, "columns": [ { "columnName": string, "savedColumnName": string, "customDimensionName": string, "customMetricName": string, "headerText": string, "startDate": string, "endDate": string, "groupByColumn": boolean, "platformSource": string, "productReportPerspective": string } ], "timeRange": { "startDate": string, "endDate": string, "changedMetricsSinceTimestamp": datetime, "changedAttributesSinceTimestamp": datetime }, "filters": [ { "column": { "columnName": string, "savedColumnName": string, "customDimensionName": string, "customMetricName": string, "headerText": string, "startDate": string, "endDate": string, "groupByColumn": boolean, "platformSource": string, "productReportPerspective": string }, "operator": string, "values": [ (value) ] } ], "orderBy": [ { "column": { "columnName": string, "savedColumnName": string, "customDimensionName": string, "customMetricName": string, "headerText": string, "startDate": string, "endDate": string, "groupByColumn": boolean, "platformSource": string, "productReportPerspective": string }, "sortOrder": string } ], "includeDeletedEntities": boolean, "includeRemovedEntities": boolean, "verifySingleTimeZone": boolean, "downloadFormat": string, "statisticsCurrency": string, "startRow": integer, "rowCount": integer, "maxRowsPerFile": integer }
प्रॉपर्टी का नाम | वैल्यू | ब्यौरा | नोट |
---|---|---|---|
reportScope |
object |
रिपोर्टस्कोप, आईडी का एक सेट है, जिसका इस्तेमाल यह तय करने के लिए किया जाता है कि रिपोर्ट में इकाइयों का कौनसा सबसेट दिखाया जाएगा. सबसे निचले दायरे के आईडी से आईडी की पूरी वंशावली की ज़रूरत होती है जो एजेंसी के ज़रिए चाहिए. | |
reportScope.agencyId |
long |
DS एजेंसी आईडी. | |
reportScope.advertiserId |
long |
DS विज्ञापन देने वाले का आईडी. | |
reportScope.engineAccountId |
long |
DS इंजन खाता आईडी. | |
reportScope.campaignId |
long |
DS कैंपेन आईडी. | |
reportScope.adGroupId |
long |
DS विज्ञापन समूह आईडी. | |
reportScope.keywordId |
long |
DS कीवर्ड आईडी. | |
reportScope.adId |
long |
DS विज्ञापन आईडी. | |
reportType |
string |
इससे तय होता है कि रिपोर्ट में किस तरह की पंक्तियां दिखेंगी. उदाहरण के लिए, reportType: keyword डालने पर, रिपोर्ट की हर लाइन में किसी कीवर्ड का डेटा शामिल होगा. हर तरह के कॉलम के लिए उपलब्ध रिपोर्ट के टाइप रेफ़रंस देखें. |
|
columns[] |
list |
रिपोर्ट में शामिल किए जाने वाले कॉलम. इसमें DoubleClick खोज स्तंभ और सहेजे गए स्तंभ, दोनों शामिल हैं. DoubleClick खोज कॉलम के लिए, सिर्फ़ columnName पैरामीटर ज़रूरी है. सेव किए गए कॉलम के लिए, सिर्फ़ savedColumnName पैरामीटर ज़रूरी है. columnName और savedColumnName को एक ही क्रम में सेट नहीं किया जा सकता. हर अनुरोध में ज़्यादा से ज़्यादा 300 कॉलम हो सकते हैं. |
|
columns[].columnName |
string |
रिपोर्ट में शामिल करने के लिए, DoubleClick खोज कॉलम का नाम. | |
columns[].savedColumnName |
string |
सेव किए गए कॉलम का नाम, जिसे रिपोर्ट में शामिल करना है. रिपोर्ट का दायरा विज्ञापनदाता या उससे कम पर होना चाहिए और यह सहेजा गया स्तंभ पहले से DoubleClick खोज यूज़र इंटरफ़ेस (यूआई) में बनाया जाना चाहिए. | |
columns[].headerText |
string |
रिपोर्ट आउटपुट में इस कॉलम की पहचान करने के लिए इस्तेमाल किया जाने वाला टेक्स्ट; तय न होने पर डिफ़ॉल्ट रूप से columnName या savedColumnName हो जाता है. इसका इस्तेमाल DoubleClick Search कॉलम और सेव किए गए कॉलम के बीच टकराव से बचने के लिए किया जा सकता है. |
|
columns[].startDate |
string |
YYYY-MM-DD फ़ॉर्मैट में शामिल करने की तारीख. अगर इसे दिया जाता है, तो इससे सिर्फ़ इस कॉलम की रिपोर्ट की कुल समयसीमा बदल जाती है. endDate के साथ दी जानी चाहिए. |
|
columns[].endDate |
string |
YYYY-MM-DD फ़ॉर्मैट में दिन शामिल है. अगर इसे दिया जाता है, तो इससे सिर्फ़ इस कॉलम की रिपोर्ट की कुल समयसीमा बदल जाती है. startDate के साथ दी जानी चाहिए. |
|
columns[].groupByColumn |
boolean |
सिर्फ़ सिंक्रोनस रिपोर्ट. true को इस कॉलम के हिसाब से ग्रुप करने के लिए सेट करें. false पर डिफ़ॉल्ट. |
|
timeRange |
object |
अगर किसी रिपोर्ट में मेट्रिक के लिए अनुरोध किया जाता है, तो इस आर्ग्युमेंट का इस्तेमाल मेट्रिक की समयसीमा को सीमित करने के लिए किया जाएगा. | |
timeRange.startDate |
string |
YYYY-MM-DD फ़ॉर्मैट में शामिल करने की तारीख. | |
timeRange.endDate |
string |
YYYY-MM-DD फ़ॉर्मैट में शामिल करने की तारीख. | |
timeRange.changedMetricsSinceTimestamp |
datetime |
आरएफ़सी फ़ॉर्मैट में इनक्लूसिव यूटीसी टाइमस्टैंप, जैसे कि 2013-07-16T10:16:23.555Z . मेट्रिक की बदली गई रिपोर्ट के काम करने के तरीके के बारे में ज़्यादा जानकारी देखें. |
|
timeRange.changedAttributesSinceTimestamp |
datetime |
आरएफ़सी फ़ॉर्मैट में इनक्लूसिव यूटीसी टाइमस्टैंप, जैसे कि 2013-07-16T10:16:23.555Z . एट्रिब्यूट की बदली गई रिपोर्ट के काम करने के तरीके के बारे में ज़्यादा जानकारी देखें. |
|
filters[] |
list |
रिपोर्ट पर लागू किए जाने वाले फ़िल्टर की सूची. हर अनुरोध के लिए, ज़्यादा से ज़्यादा 300 फ़िल्टर इस्तेमाल किए जा सकते हैं. |
|
filters[].column |
nested object |
फ़िल्टर लगाने के लिए कॉलम. यह DoubleClick खोज कॉलम या सेव किया गया कॉलम हो सकता है. | |
filters[].column.columnName |
string |
रिपोर्ट में शामिल करने के लिए, DoubleClick खोज कॉलम का नाम. | |
filters[].column.savedColumnName |
string |
सेव किए गए कॉलम का नाम, जिसे रिपोर्ट में शामिल करना है. रिपोर्ट का दायरा विज्ञापनदाता या उससे कम पर होना चाहिए और यह सहेजा गया स्तंभ पहले से DoubleClick खोज यूज़र इंटरफ़ेस (यूआई) में बनाया जाना चाहिए. | |
filters[].operator |
string |
फ़िल्टर में इस्तेमाल करने के लिए ऑपरेटर. उपलब्ध ऑपरेटर की सूची के लिए फ़िल्टर संदर्भ देखें. | |
filters[].values[] |
list |
वैल्यू की सूची, जिससे कॉलम की वैल्यू को फ़िल्टर किया जा सकता है. हर अनुरोध के लिए, ज़्यादा से ज़्यादा 300 फ़िल्टर वैल्यू ही डाली जा सकती हैं. |
|
orderBy[] |
list |
सिर्फ़ सिंक्रोनस रिपोर्ट. रिपोर्ट की लाइनों में, एक क्रम में लगाए जाने वाले कॉलम और निर्देशों की सूची. एक बार में 300 से ज़्यादा ऑर्डर नहीं किए जा सकते. |
|
orderBy[].column |
nested object |
क्रम से लगाने के लिए कॉलम. यह DoubleClick Search पर आधारित कोई कॉलम या सेव किया गया कॉलम हो सकता है. | |
orderBy[].column.columnName |
string |
रिपोर्ट में शामिल करने के लिए, DoubleClick खोज कॉलम का नाम. | |
orderBy[].column.savedColumnName |
string |
सेव किए गए कॉलम का नाम, जिसे रिपोर्ट में शामिल करना है. रिपोर्ट का दायरा विज्ञापनदाता या उससे कम पर होना चाहिए और यह सहेजा गया स्तंभ पहले से DoubleClick खोज यूज़र इंटरफ़ेस (यूआई) में बनाया जाना चाहिए. | |
orderBy[].sortOrder |
string |
क्रम से लगाने की दिशा, जो ascending या descending है. |
|
includeDeletedEntities |
boolean |
इससे तय होता है कि हटाई गई इकाइयों को रिपोर्ट में शामिल किया जाना चाहिए या नहीं. false पर डिफ़ॉल्ट. बहिष्कृत, कृपया इसके बजाय includeRemovedEntities का उपयोग करें. |
|
verifySingleTimeZone |
boolean |
अगर true है, तो रिपोर्ट सिर्फ़ तब बनाई जाएगी, जब सभी ज़रूरी डेटा एक ही समय क्षेत्र से लिया गया हो. false पर डिफ़ॉल्ट. |
|
downloadFormat |
string |
वह फ़ॉर्मैट जिसमें रिपोर्ट वापस करनी है. फ़िलहाल, csv या tsv के साथ काम करता है. |
|
statisticsCurrency |
string |
वह मुद्रा तय करता है जिसमें मुद्रा वापस की जाती है. संभावित वैल्यू ये हैं: usd , agency (अगर रिपोर्ट, एजेंसी या उससे पहले के दायरे में आती है, तो advertiser ), (अगर रिपोर्ट, * विज्ञापन देने वाले या इससे कम पर दायरे में है, तो मान्य है) या account (अगर रिपोर्ट, इंजन खाते या उससे पहले के दायरे में है, तो मान्य है). |
|
startRow |
integer |
सिर्फ़ सिंक्रोनस रिपोर्ट. पहली पंक्ति की शून्य-आधारित इंडेक्स. 0 से 50000 तक के मान स्वीकार किए जाते हैं. 0 पर डिफ़ॉल्ट. |
|
rowCount |
integer |
सिर्फ़ सिंक्रोनस रिपोर्ट. लौटाने की पंक्तियों की अधिकतम संख्या; अतिरिक्त पंक्तियां छोड़ दी गई हैं. 0 से 10000 तक के मान स्वीकार किए जाते हैं. 10000 पर डिफ़ॉल्ट. |
|
maxRowsPerFile |
integer |
सिर्फ़ एसिंक्रोनस रिपोर्ट. हर रिपोर्ट फ़ाइल में पंक्तियों की ज़्यादा से ज़्यादा संख्या. एक बड़ी रिपोर्ट को इस फ़ील्ड के आधार पर कई फ़ाइलों में बांटा जाता है. 1000000 से 100000000 तक के मान स्वीकार किए जाते हैं. |
|
includeRemovedEntities |
boolean |
इससे तय होता है कि हटाई गई इकाइयों को रिपोर्ट में शामिल किया जाना चाहिए या नहीं. false पर डिफ़ॉल्ट. |
|
columns[].customDimensionName |
string |
रिपोर्ट को कस्टम डाइमेंशन के हिसाब से सेगमेंट करता है. रिपोर्ट का दायरा, विज्ञापन देने वाले या उससे कम पर होना चाहिए. साथ ही, कस्टम डाइमेंशन पहले से ही DoubleClick Search में सेट अप होना चाहिए. DoubleClick खोज में दिखाई देने वाला कस्टम आयाम नाम, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होता है. अगर इसका इस्तेमाल कन्वर्ज़न रिपोर्ट में किया जाता है, तो दिए गए कन्वर्ज़न के लिए तय किए गए कस्टम डाइमेंशन की वैल्यू दिखती है. ऐसा तब होता है, जब यह सेट हो. यह कॉलम, कन्वर्ज़न रिपोर्ट को सेगमेंट नहीं करता. |
|
columns[].platformSource |
string |
कस्टम डाइमेंशन के लिए डेटा देने के लिए इस्तेमाल किया जाने वाला प्लैटफ़ॉर्म. स्वीकार की जाने वाली वैल्यू "बाढ़ की रोशनी" है. | |
filters[].column.customDimensionName |
string |
रिपोर्ट को कस्टम डाइमेंशन के हिसाब से सेगमेंट करता है. रिपोर्ट का दायरा, विज्ञापन देने वाले या उससे कम पर होना चाहिए. साथ ही, कस्टम डाइमेंशन पहले से ही DoubleClick Search में सेट अप होना चाहिए. DoubleClick खोज में दिखाई देने वाला कस्टम आयाम नाम, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होता है. अगर इसका इस्तेमाल कन्वर्ज़न रिपोर्ट में किया जाता है, तो दिए गए कन्वर्ज़न के लिए तय किए गए कस्टम डाइमेंशन की वैल्यू दिखती है. ऐसा तब होता है, जब यह सेट हो. यह कॉलम, कन्वर्ज़न रिपोर्ट को सेगमेंट नहीं करता. |
|
filters[].column.headerText |
string |
रिपोर्ट आउटपुट में इस कॉलम की पहचान करने के लिए इस्तेमाल किया जाने वाला टेक्स्ट; तय न होने पर डिफ़ॉल्ट रूप से columnName या savedColumnName हो जाता है. इसका इस्तेमाल DoubleClick Search कॉलम और सेव किए गए कॉलम के बीच टकराव से बचने के लिए किया जा सकता है. |
|
filters[].column.startDate |
string |
YYYY-MM-DD फ़ॉर्मैट में शामिल करने की तारीख. अगर इसे दिया जाता है, तो इससे सिर्फ़ इस कॉलम की रिपोर्ट की कुल समयसीमा बदल जाती है. endDate के साथ दी जानी चाहिए. |
|
filters[].column.endDate |
string |
YYYY-MM-DD फ़ॉर्मैट में दिन शामिल है. अगर इसे दिया जाता है, तो इससे सिर्फ़ इस कॉलम की रिपोर्ट की कुल समयसीमा बदल जाती है. startDate के साथ दी जानी चाहिए. |
|
filters[].column.groupByColumn |
boolean |
सिर्फ़ सिंक्रोनस रिपोर्ट. true को इस कॉलम के हिसाब से ग्रुप करने के लिए सेट करें. false पर डिफ़ॉल्ट. |
|
filters[].column.platformSource |
string |
कस्टम डाइमेंशन के लिए डेटा देने के लिए इस्तेमाल किया जाने वाला प्लैटफ़ॉर्म. स्वीकार की जाने वाली वैल्यू "बाढ़ की रोशनी" है. | |
orderBy[].column.customDimensionName |
string |
रिपोर्ट को कस्टम डाइमेंशन के हिसाब से सेगमेंट करता है. रिपोर्ट का दायरा, विज्ञापन देने वाले या उससे कम पर होना चाहिए. साथ ही, कस्टम डाइमेंशन पहले से ही DoubleClick Search में सेट अप होना चाहिए. DoubleClick खोज में दिखाई देने वाला कस्टम आयाम नाम, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होता है. अगर इसका इस्तेमाल कन्वर्ज़न रिपोर्ट में किया जाता है, तो दिए गए कन्वर्ज़न के लिए तय किए गए कस्टम डाइमेंशन की वैल्यू दिखती है. ऐसा तब होता है, जब यह सेट हो. यह कॉलम, कन्वर्ज़न रिपोर्ट को सेगमेंट नहीं करता. |
|
orderBy[].column.headerText |
string |
रिपोर्ट आउटपुट में इस कॉलम की पहचान करने के लिए इस्तेमाल किया जाने वाला टेक्स्ट; तय न होने पर डिफ़ॉल्ट रूप से columnName या savedColumnName हो जाता है. इसका इस्तेमाल DoubleClick Search कॉलम और सेव किए गए कॉलम के बीच टकराव से बचने के लिए किया जा सकता है. |
|
orderBy[].column.startDate |
string |
YYYY-MM-DD फ़ॉर्मैट में शामिल करने की तारीख. अगर इसे दिया जाता है, तो इससे सिर्फ़ इस कॉलम की रिपोर्ट की कुल समयसीमा बदल जाती है. endDate के साथ दी जानी चाहिए. |
|
orderBy[].column.endDate |
string |
YYYY-MM-DD फ़ॉर्मैट में दिन शामिल है. अगर इसे दिया जाता है, तो इससे सिर्फ़ इस कॉलम की रिपोर्ट की कुल समयसीमा बदल जाती है. startDate के साथ दी जानी चाहिए. |
|
orderBy[].column.groupByColumn |
boolean |
सिर्फ़ सिंक्रोनस रिपोर्ट. true को इस कॉलम के हिसाब से ग्रुप करने के लिए सेट करें. false पर डिफ़ॉल्ट. |
|
orderBy[].column.platformSource |
string |
कस्टम डाइमेंशन के लिए डेटा देने के लिए इस्तेमाल किया जाने वाला प्लैटफ़ॉर्म. स्वीकार की जाने वाली वैल्यू "बाढ़ की रोशनी" है. | |
columns[].customMetricName |
string |
रिपोर्ट में शामिल करने के लिए कस्टम मेट्रिक का नाम. रिपोर्ट, विज्ञापन देने वाले या उससे कम के दायरे में होनी चाहिए. साथ ही, कस्टम मेट्रिक पहले से ही DoubleClick Search में सेट अप होना चाहिए. DoubleClick खोज में दिखाई देने वाला कस्टम मेट्रिक नाम, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होता है. | |
filters[].column.customMetricName |
string |
रिपोर्ट में शामिल करने के लिए कस्टम मेट्रिक का नाम. रिपोर्ट, विज्ञापन देने वाले या उससे कम के दायरे में होनी चाहिए. साथ ही, कस्टम मेट्रिक पहले से ही DoubleClick Search में सेट अप होना चाहिए. DoubleClick खोज में दिखाई देने वाला कस्टम मेट्रिक नाम, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होता है. | |
orderBy[].column.customMetricName |
string |
रिपोर्ट में शामिल करने के लिए कस्टम मेट्रिक का नाम. रिपोर्ट, विज्ञापन देने वाले या उससे कम के दायरे में होनी चाहिए. साथ ही, कस्टम मेट्रिक पहले से ही DoubleClick Search में सेट अप होना चाहिए. DoubleClick खोज में दिखाई देने वाला कस्टम मेट्रिक नाम, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होता है. | |
columns[].productReportPerspective |
string |
सिर्फ़ खास तरह की प्रॉडक्ट गतिविधि के लिए मेट्रिक दिखाता है. स्वीकार की जाने वाली वैल्यू ये हैं:
|
|
filters[].column.productReportPerspective |
string |
सिर्फ़ खास तरह की प्रॉडक्ट गतिविधि के लिए मेट्रिक दिखाता है. स्वीकार की जाने वाली वैल्यू ये हैं:
|
|
orderBy[].column.productReportPerspective |
string |
सिर्फ़ खास तरह की प्रॉडक्ट गतिविधि के लिए मेट्रिक दिखाता है. स्वीकार की जाने वाली वैल्यू ये हैं:
|
जवाब
अगर यह तरीका कारगर होता है, तो यह जवाब के मुख्य भाग में रिपोर्ट संसाधन दिखाता है.
इसे आज़माएं!
इस तरीके को लाइव डेटा पर कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें. विकल्प के तौर पर, Standalone Explorer को आज़माएं.