Search Ads 360 Reporting API के पुराने वर्शन को बंद किया जा रहा है. इसे 30 जून, 2024 को बंद कर दिया जाएगा. ध्यान दें कि Search Ads 360 Conversion API पर इसका कोई असर नहीं पड़ा है. साथ ही, यह पहले की तरह काम करता रहेगा. सभी नए रिपोर्टिंग डेवलपमेंट में, Search Ads 360 Reporting API के नए वर्शन का इस्तेमाल होना चाहिए.

अप्रैल 2024 से, रिपोर्ट का अनुरोध करते समय, काम न करने वाला ApiVersion गड़बड़ी दिखेगी. विवरण यहां देखें.

हमारा यह सुझाव भी है कि आप Search Ads 360 पर लागू होने वाले सभी मौजूदा वर्शन को एपीआई के नए वर्शन पर माइग्रेट करें. ज़्यादा जानकारी के लिए, Search Ads 360 Reporting API का नया वर्शन शुरू करने का तरीका और माइग्रेशन गाइड देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

Reports: request

रिपोर्ट करने वाले सिस्टम में, रिपोर्ट शामिल करता है. इसे अभी आज़माएं.

अनुरोध करें

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

POST https://www.googleapis.com/doubleclicksearch/v2/reports

अनुमति दें

इस अनुरोध के लिए नीचे दिए गए दायरे की अनुमति चाहिए:

दायरा
`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`	सिर्फ़ खास तरह की प्रॉडक्ट गतिविधि के लिए मेट्रिक दिखाता है. स्वीकार की जाने वाली वैल्यू ये हैं: "`sold`": सिर्फ़ उन प्रॉडक्ट की मेट्रिक दिखाता है जो बेचे गए थे "`advertised`": यह सिर्फ़ उन प्रॉडक्ट की मेट्रिक दिखाता है जिनका शॉपिंग कैंपेन में विज्ञापन किया गया था और शायद वे बिक चुके हैं
`filters[].column.productReportPerspective`	`string`	सिर्फ़ खास तरह की प्रॉडक्ट गतिविधि के लिए मेट्रिक दिखाता है. स्वीकार की जाने वाली वैल्यू ये हैं: "`sold`": सिर्फ़ उन प्रॉडक्ट की मेट्रिक दिखाता है जो बेचे गए थे "`advertised`": यह सिर्फ़ उन प्रॉडक्ट की मेट्रिक दिखाता है जिनका शॉपिंग कैंपेन में विज्ञापन किया गया था और शायद वे बिक चुके हैं
`orderBy[].column.productReportPerspective`	`string`	सिर्फ़ खास तरह की प्रॉडक्ट गतिविधि के लिए मेट्रिक दिखाता है. स्वीकार की जाने वाली वैल्यू ये हैं: "`sold`": सिर्फ़ उन प्रॉडक्ट की मेट्रिक दिखाता है जो बेचे गए थे "`advertised`": यह सिर्फ़ उन प्रॉडक्ट की मेट्रिक दिखाता है जिनका शॉपिंग कैंपेन में विज्ञापन किया गया था और शायद वे बिक चुके हैं

जवाब

अगर यह तरीका कारगर होता है, तो यह जवाब के मुख्य भाग में रिपोर्ट संसाधन दिखाता है.

इसे आज़माएं!

इस तरीके को लाइव डेटा पर कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें. विकल्प के तौर पर, Standalone Explorer को आज़माएं.