Queries

इस संसाधन के लिए उपलब्ध तरीकों की सूची देखने के लिए, इस पेज के आखिर में देखें.

संसाधन निरूपण

यह क्वेरी को दिखाता है.

{
  "kind": "doubleclickbidmanager#query",
  "queryId": long,
  "metadata": {
    "title": string,
    "dataRange": string,
    "format": string,
    "running": boolean,
    "reportCount": integer,
    "googleCloudStoragePathForLatestReport": string,
    "latestReportRunTimeMs": long,
    "googleDrivePathForLatestReport": string,
    "sendNotification": boolean,
    "shareEmailAddress": [
      string
    ],
    "locale": string
  },
  "params": {
    "type": string,
    "groupBys": [
      string
    ],
    "filters": [
      {
        "type": string,
        "value": string
      }
    ],
    "metrics": [
      string
    ],
    "includeInviteData": boolean
  },
  "schedule": {
    "frequency": string,
    "endTimeMs": long,
    "nextRunMinuteOfDay": integer,
    "nextRunTimezoneCode": string
  },
  "reportDataStartTimeMs": long,
  "reportDataEndTimeMs": long,
  "timezoneCode": string
}
प्रॉपर्टी का नाम मान ब्यौरा नोट
kind string इससे पता चलता है कि यह किस तरह का संसाधन है. वैल्यू: तय स्ट्रिंग "doubleclickbidmanager#query".
metadata nested object क्वेरी का मेटाडेटा.
metadata.dataRange string रिपोर्ट डेटा की रेंज.

ये वैल्यू स्वीकार की जाती हैं:
  • "ALL_TIME"
  • "CURRENT_DAY"
  • "CUSTOM_DATES"
  • "LAST_14_DAYS"
  • "LAST_30_DAYS"
  • "LAST_365_DAYS"
  • "LAST_7_DAYS"
  • "LAST_90_DAYS"
  • "MONTH_TO_DATE"
  • "PREVIOUS_DAY"
  • "PREVIOUS_HALF_MONTH"
  • "PREVIOUS_MONTH"
  • "PREVIOUS_QUARTER"
  • "PREVIOUS_WEEK"
  • "PREVIOUS_YEAR"
  • "QUARTER_TO_DATE"
  • "TYPE_NOT_SUPPORTED"
  • "WEEK_TO_DATE"
  • "YEAR_TO_DATE"
metadata.format string जनरेट की गई रिपोर्ट का फ़ॉर्मैट.

ये वैल्यू स्वीकार की जाती हैं:
  • "CSV"
  • "EXCEL_CSV"
  • "XLSX"
metadata.googleCloudStoragePathForLatestReport string Google Cloud Storage में उस जगह का पाथ जहां नई रिपोर्ट सेव की गई है.
metadata.googleDrivePathForLatestReport string नई रिपोर्ट के लिए, Google Drive में पाथ.
metadata.latestReportRunTimeMs long नई रिपोर्ट चलने का समय.
metadata.locale string

जनरेट की गई रिपोर्ट की स्थान-भाषा. ये वैल्यू स्वीकार की जाती हैं:

  • "cs" चेक के लिए
  • "de" जर्मन के लिए
  • "en" अंग्रेज़ी के लिए
  • "es" स्पैनिश के लिए
  • "fr" फ़्रेंच के लिए
  • "it" इतालवी के लिए
  • "ja" जापान के लिए
  • "ko" कोरिया के लिए
  • "pl" पोलिश के लिए
  • "pt-BR" ब्राज़ील के लिए
  • "ru" रूसी के लिए
  • "tr" तुर्किये के लिए
  • "uk" यूक्रेनियन के लिए
  • "zh-CN" CHINA_CHINESE के लिए
  • "zh-TW" TAIWAN_CHINESE के लिए

जो स्थान-भाषा स्ट्रिंग ऊपर दी गई सूची में नहीं है वह अंग्रेज़ी में रिपोर्ट जनरेट करेगी.
metadata.reportCount integer किसी क्वेरी के लिए जनरेट हुई रिपोर्ट की संख्या.
metadata.running boolean नई रिपोर्ट चल रही है या नहीं.
metadata.sendNotification boolean रिपोर्ट तैयार होने पर, ईमेल सूचना भेजी जाए या नहीं. डिफ़ॉल्ट रूप से 'गलत' पर सेट होती है.
metadata.shareEmailAddress[] list उन ईमेल पतों की सूची जिन्हें रिपोर्ट खत्म होने पर ईमेल सूचनाएं भेजी जाती हैं. sendNotification से अलग.
metadata.title string क्वेरी का टाइटल. इसका इस्तेमाल इस क्वेरी से जनरेट की गई रिपोर्ट को नाम देने के लिए किया जाता है.
params nested object क्वेरी पैरामीटर.
params.filters[] list आपकी रिपोर्ट में ट्रैफ़िक डेटा को मैच करने के लिए इस्तेमाल किए जाने वाले फ़िल्टर.
params.filters[].type string फ़िल्टर का टाइप.

ये वैल्यू स्वीकार की जाती हैं:
  • "FILTER_ACTIVE_VIEW_EXPECTED_VIEWABILITY"
  • "FILTER_ACTIVITY_ID"
  • "FILTER_ADVERTISER"
  • "FILTER_ADVERTISER_CURRENCY"
  • "FILTER_ADVERTISER_TIMEZONE"
  • "FILTER_AD_POSITION"
  • "FILTER_AGE"
  • "FILTER_AUTHORIZED_SELLER_STATE_ID"
  • "FILTER_BRANDSAFE_CHANNEL_ID"
  • "FILTER_BROWSER"
  • "FILTER_BUDGET_SEGMENT_DESCRIPTION"
  • "FILTER_CAMPAIGN_DAILY_FREQUENCY"
  • "FILTER_CARRIER"
  • "FILTER_CHANNEL_ID"
  • "FILTER_CITY"
  • "FILTER_COMPANION_CREATIVE_ID"
  • "FILTER_CONVERSION_DELAY"
  • "FILTER_COUNTRY"
  • "FILTER_CREATIVE_ATTRIBUTE"
  • "FILTER_CREATIVE_HEIGHT"
  • "FILTER_CREATIVE_ID"
  • "FILTER_CREATIVE_SIZE"
  • "FILTER_CREATIVE_TYPE"
  • "FILTER_CREATIVE_WIDTH"
  • "FILTER_DATA_PROVIDER"
  • "FILTER_DATE"
  • "FILTER_DAY_OF_WEEK"
  • "FILTER_DEVICE_MAKE"
  • "FILTER_DEVICE_MODEL"
  • "FILTER_DEVICE_TYPE"
  • "FILTER_DFP_ORDER_ID"
  • "FILTER_DMA"
  • "FILTER_DV360_ACTIVITY_ID"
  • "FILTER_EXCHANGE_ID"
  • "FILTER_FLOODLIGHT_ACTIVITY_ID"
  • "FILTER_FLOODLIGHT_PIXEL_ID"
  • "FILTER_GENDER"
  • "FILTER_INSERTION_ORDER"
  • "FILTER_INVENTORY_COMMITMENT_TYPE"
  • "FILTER_INVENTORY_DELIVERY_METHOD"
  • "FILTER_INVENTORY_FORMAT"
  • "FILTER_INVENTORY_RATE_TYPE"
  • "FILTER_INVENTORY_SOURCE"
  • "FILTER_INVENTORY_SOURCE_TYPE"
  • "FILTER_KEYWORD"
  • "FILTER_LINE_ITEM"
  • "FILTER_LINE_ITEM_DAILY_FREQUENCY"
  • "FILTER_LINE_ITEM_LIFETIME_FREQUENCY"
  • "FILTER_LINE_ITEM_TYPE"
  • "FILTER_MEDIA_PLAN"
  • "FILTER_MOBILE_DEVICE_MAKE"
  • "FILTER_MOBILE_DEVICE_MAKE_MODEL"
  • "FILTER_MOBILE_DEVICE_TYPE"
  • "FILTER_MOBILE_GEO"
  • "FILTER_MONTH"
  • "FILTER_MRAID_SUPPORT"
  • "FILTER_NIELSEN_AGE"
  • "FILTER_NIELSEN_COUNTRY_CODE"
  • "FILTER_NIELSEN_DEVICE_ID"
  • "FILTER_NIELSEN_GENDER"
  • "FILTER_NOT_SUPPORTED"
  • "FILTER_ORDER_ID"
  • "FILTER_OS"
  • "FILTER_PAGE_CATEGORY"
  • "FILTER_PAGE_LAYOUT"
  • "FILTER_PARTNER"
  • "FILTER_PARTNER_CURRENCY"
  • "FILTER_PUBLIC_INVENTORY"
  • "FILTER_QUARTER"
  • "FILTER_REGION"
  • "FILTER_REGULAR_CHANNEL_ID"
  • "FILTER_SITE_ID"
  • "FILTER_SITE_LANGUAGE"
  • "FILTER_SKIPPABLE_SUPPORT"
  • "FILTER_TARGETED_USER_LIST"
  • "FILTER_TIME_OF_DAY"
  • "FILTER_TRUEVIEW_AD_GROUP_AD_ID"
  • "FILTER_TRUEVIEW_AD_GROUP_ID"
  • "FILTER_TRUEVIEW_AGE"
  • "FILTER_TRUEVIEW_CATEGORY"
  • "FILTER_TRUEVIEW_CITY"
  • "FILTER_TRUEVIEW_CONVERSION_TYPE"
  • "FILTER_TRUEVIEW_COUNTRY"
  • "FILTER_TRUEVIEW_CUSTOM_AFFINITY"
  • "FILTER_TRUEVIEW_DMA"
  • "FILTER_TRUEVIEW_GENDER"
  • "FILTER_TRUEVIEW_IAR_AGE"
  • "FILTER_TRUEVIEW_IAR_CATEGORY"
  • "FILTER_TRUEVIEW_IAR_CITY"
  • "FILTER_TRUEVIEW_IAR_COUNTRY"
  • "FILTER_TRUEVIEW_IAR_GENDER"
  • "FILTER_TRUEVIEW_IAR_INTEREST"
  • "FILTER_TRUEVIEW_IAR_LANGUAGE"
  • "FILTER_TRUEVIEW_IAR_PARENTAL_STATUS"
  • "FILTER_TRUEVIEW_IAR_REGION"
  • "FILTER_TRUEVIEW_IAR_REMARKETING_LIST"
  • "FILTER_TRUEVIEW_IAR_TIME_OF_DAY"
  • "FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL"
  • "FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO"
  • "FILTER_TRUEVIEW_IAR_ZIPCODE"
  • "FILTER_TRUEVIEW_INTEREST"
  • "FILTER_TRUEVIEW_KEYWORD"
  • "FILTER_TRUEVIEW_PARENTAL_STATUS"
  • "FILTER_TRUEVIEW_PLACEMENT"
  • "FILTER_TRUEVIEW_REGION"
  • "FILTER_TRUEVIEW_REMARKETING_LIST"
  • "FILTER_TRUEVIEW_URL"
  • "FILTER_TRUEVIEW_ZIPCODE"
  • "FILTER_UNKNOWN"
  • "FILTER_USER_LIST"
  • "FILTER_USER_LIST_FIRST_PARTY"
  • "FILTER_USER_LIST_THIRD_PARTY"
  • "FILTER_VIDEO_AD_POSITION_IN_STREAM"
  • "FILTER_VIDEO_COMPANION_SIZE"
  • "FILTER_VIDEO_COMPANION_TYPE"
  • "FILTER_VIDEO_CREATIVE_DURATION"
  • "FILTER_VIDEO_CREATIVE_DURATION_SKIPPABLE"
  • "FILTER_VIDEO_DURATION_SECONDS"
  • "FILTER_VIDEO_FORMAT_SUPPORT"
  • "FILTER_VIDEO_INVENTORY_TYPE"
  • "FILTER_VIDEO_PLAYER_SIZE"
  • "FILTER_VIDEO_RATING_TIER"
  • "FILTER_VIDEO_SKIPPABLE_SUPPORT"
  • "FILTER_VIDEO_VPAID_SUPPORT"
  • "FILTER_WEEK"
  • "FILTER_YEAR"
  • "FILTER_YOUTUBE_VERTICAL"
  • "FILTER_ZIP_CODE"
params.filters[].value string फ़िल्टर वैल्यू.
params.groupBys[] list डेटा को इस फ़ील्ड में दिए गए फ़िल्टर के आधार पर ग्रुप में बांटा जाता है.
params.includeInviteData boolean समर्थन नहीं होना या रुकना. यह फ़ील्ड अब उपयोग में नहीं है.
params.metrics[] list अपनी रिपोर्ट में कॉलम के तौर पर शामिल करने के लिए मेट्रिक.
params.type string रिपोर्ट टाइप.

टाइप के हिसाब से सीमाएं:
  • TYPE_ORDER_ID, ज़्यादा से ज़्यादा 60 दिनों से पहले की तारीख की सीमाओं का इस्तेमाल करता है.
  • TYPE_AUDIENCE_COMPOSITION, TYPE_INVENTORY_AVAILABILITY, TYPE_TRUEVIEW_IAR सहायता पाने की तारीख की सीमा ज़्यादा से ज़्यादा 30 दिन पहले की है.


ये वैल्यू स्वीकार की जाती हैं:
  • "TYPE_ACTIVE_GRP"
  • "TYPE_AUDIENCE_COMPOSITION"
  • "TYPE_AUDIENCE_PERFORMANCE"
  • "TYPE_CLIENT_SAFE"
  • "TYPE_COMSCORE_VCE"
  • "TYPE_CROSS_FEE"
  • "TYPE_CROSS_PARTNER"
  • "TYPE_CROSS_PARTNER_THIRD_PARTY_DATA_PROVIDER"
  • "TYPE_ESTIMATED_CONVERSION"
  • "TYPE_FEE"
  • "TYPE_GENERAL"
  • "TYPE_INVENTORY_AVAILABILITY"
  • "TYPE_KEYWORD"
  • "TYPE_LINEAR_TV_SEARCH_LIFT"
  • "TYPE_NIELSEN_AUDIENCE_PROFILE"
  • "TYPE_NIELSEN_DAILY_REACH_BUILD"
  • "TYPE_NIELSEN_ONLINE_GLOBAL_MARKET"
  • "TYPE_NIELSEN_SITE"
  • "TYPE_NOT_SUPPORTED"
  • "TYPE_ORDER_ID"
  • "TYPE_PAGE_CATEGORY"
  • "TYPE_PETRA_NIELSEN_AUDIENCE_PROFILE"
  • "TYPE_PETRA_NIELSEN_DAILY_REACH_BUILD"
  • "TYPE_PETRA_NIELSEN_ONLINE_GLOBAL_MARKET"
  • "TYPE_PIXEL_LOAD"
  • "TYPE_REACH_AND_FREQUENCY"
  • "TYPE_REACH_AUDIENCE"
  • "TYPE_THIRD_PARTY_DATA_PROVIDER"
  • "TYPE_TRUEVIEW"
  • "TYPE_TRUEVIEW_IAR"
  • "TYPE_VERIFICATION"
  • "TYPE_YOUTUBE_VERTICAL"
queryId long क्वेरी आईडी.
reportDataEndTimeMs long रिपोर्ट में दिखाया गया डेटा खत्म होने का समय. ध्यान दें, अगर metadata.dataRange को CUSTOM_DATES है, तो reportDataEndTimeMs ज़रूरी है. इसे अनदेखा कर दिया जाता है.
reportDataStartTimeMs long रिपोर्ट में दिखने वाला डेटा शुरू होने का समय. ध्यान दें, अगर metadata.dataRange को CUSTOM_DATES है, तो reportDataStartTimeMs ज़रूरी है. इसे अनदेखा कर दिया जाता है.
schedule nested object इस बारे में जानकारी कि क्वेरी कितनी बार और कब चलाई जाए.
schedule.endTimeMs long क्वेरी को समय-समय पर चलाने के लिए तारीख और समय.
schedule.frequency string क्वेरी को कितनी बार चलाया जाता है.

ये वैल्यू स्वीकार की जाती हैं:
  • "DAILY"
  • "MONTHLY"
  • "ONE_TIME"
  • "QUARTERLY"
  • "SEMI_MONTHLY"
  • "WEEKLY"
schedule.nextRunMinuteOfDay integer समर्थन नहीं होना या रुकना. इस फ़ील्ड का कोई असर नहीं है.
schedule.nextRunTimezoneCode string रिपोर्ट जनरेट करने के समय के लिए कैननिकल टाइमज़ोन कोड. डिफ़ॉल्ट तौर पर, यह America/New_York पर सेट होता है.
timezoneCode string रिपोर्ट के डेटा के समय के लिए कैननिकल टाइमज़ोन कोड. डिफ़ॉल्ट तौर पर, यह America/New_York पर सेट होता है.

तरीके

createquery
क्वेरी बनाता है.
deletequery
सेव की गई क्वेरी के साथ-साथ, उससे जुड़ी सेव की गई रिपोर्ट को मिटा देता है.
getquery
सेव की गई क्वेरी फ़ेच करता है.
listqueries
सेव की गई क्वेरी फ़ेच की जाती है.
रनक्वेरी
रिपोर्ट जनरेट करने के लिए, सेव की गई क्वेरी चलाता है.