تمت ترجمة هذه الصفحة بواسطة 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`" لـ POLISH "`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`	وقت انتهاء البيانات التي تظهر في التقرير. ملاحظة: يجب توفير السمة `reportDataEndTimeMs` إذا كانت قيمة السمة `metadata.dataRange` هي `CUSTOM_DATES` ويتم تجاهلها في الحالات الأخرى.
`reportDataStartTimeMs`	`long`	وقت بدء البيانات التي تظهر في التقرير. ملاحظة: يجب توفير السمة `reportDataStartTimeMs` إذا كانت قيمة السمة `metadata.dataRange` هي `CUSTOM_DATES` ويتم تجاهلها في الحالات الأخرى.
`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: يسترد طلبات البحث المخزَّنة.
runquery: يجري طلب بحث مخزّنًا لإنشاء تقرير.

Queries تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

تمثيلات الموارد

الطُرق

Queries