این صفحه به‌وسیله ‏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` .

روش ها

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

Queries با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

بازنمایی منابع

روش ها

Queries