ما در حال حاضر در حال انتقال زیرمجموعه ای از انواع گزارش از آفلاین به گزارش فوری هستیم. پس از انتقال کاربر، پاسخ‌های queries.list شامل گزارش‌های فوری موجود می‌شود. برای اطلاعات بیشتر به پست وبلاگ ما مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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` " برای BRAZILIAN_PORTUGUESE " `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`	Datetime برای اجرای دوره ای پرس و جو تا زمانی که.
`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` .

مواد و روش ها

ایجاد پرس و جو: یک پرس و جو ایجاد می کند.
حذف: یک پرس و جو ذخیره شده و همچنین گزارش های ذخیره شده مرتبط را حذف می کند.
دریافت پرس و جو: یک پرس و جو ذخیره شده را بازیابی می کند.
فهرست استعلام ها: پرس و جوهای ذخیره شده را بازیابی می کند.
راندوکری: یک کوئری ذخیره شده را برای تولید گزارش اجرا می کند.