אנחנו מעבירים בשלב זה קבוצת משנה של סוגי דוחות מדיווח אופליין לדיווח מיידי. אחרי העברת משתמש, התגובות של queries.list יכללו דוחות מיידיים קיימים. בפוסט הזה בבלוג אפשר לקרוא מידע נוסף.

דף זה תורגם על ידי Cloud Translation API.

Queries

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

מייצג שאילתה.

{
  "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` לצ'כיה (CZECH) `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`	הגדרה שקובעת אם לשלוח התראה באימייל כשהדוח מוכן. ברירת המחדל היא False.
`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