Esta página foi traduzida pela API Cloud Translation.

Queries

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Representa uma consulta.

{
  "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
}

Nome da propriedade	Valor	Descrição
`kind`	`string`	Identifica o tipo de recurso. Valor: a string fixa `"doubleclickbidmanager#query"`.
`metadata`	`nested object`	Metadados de consulta.
`metadata.dataRange`	`string`	Intervalo de dados do relatório. Os valores aceitáveis são: "`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`	Formato do relatório gerado. Os valores aceitáveis são: "`CSV`" "`EXCEL_CSV`" "`XLSX`"
`metadata.googleCloudStoragePathForLatestReport`	`string`	O caminho para o local no Google Cloud Storage onde o relatório mais recente está armazenado.
`metadata.googleDrivePathForLatestReport`	`string`	O caminho no Google Drive para o relatório mais recente.
`metadata.latestReportRunTimeMs`	`long`	A hora em que o relatório mais recente começou a ser gerado.
`metadata.locale`	`string`	Local dos relatórios gerados. Os valores aceitáveis são: "`cs`" para Tcheco "`de`" para ALEMÃO "`en`" para INGLÊS "`es`" para SPANISH "`fr`" para FRENCH "`it`" para ITALIA "`ja`" para JAPONÊS "`ko`" para KOREAN "`pl`" para POLISH "`pt-BR`" para BRAZILIAN_PORTUGUESE "`ru`" para RUSSIAN "`tr`" para TURCO "`uk`" para ucraniano "`zh-CN`" para CHINA_CHINESE "`zh-TW`" para TAIWAN_CHINESE Uma string de localidade que não está na lista acima gerará relatórios em inglês.
`metadata.reportCount`	`integer`	Número de relatórios que foram gerados para a consulta.
`metadata.running`	`boolean`	Se o relatório mais recente está sendo gerado no momento.
`metadata.sendNotification`	`boolean`	Define se uma notificação por e-mail será enviada quando um relatório estiver pronto. O padrão é "false".
`metadata.shareEmailAddress[]`	`list`	Lista de endereços de e-mail que recebem notificações quando o relatório é concluído. Separado de `sendNotification`.
`metadata.title`	`string`	Título da consulta. Ele é usado para nomear os relatórios gerados a partir da consulta.
`params`	`nested object`	Parâmetros de consulta.
`params.filters[]`	`list`	Filtros usados para fazer a correspondência dos dados de tráfego no seu relatório.
`params.filters[].type`	`string`	Tipo de filtro. Os valores aceitáveis são: "`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`	Valor do filtro.
`params.groupBys[]`	`list`	Os dados são agrupados pelos filtros listados nesse campo.
`params.includeInviteData`	`boolean`	Obsoleto. Este campo não está mais em uso.
`params.metrics[]`	`list`	Métricas a serem incluídas como colunas no relatório.
`params.type`	`string`	Tipo de relatório. Limitações específicas do tipo: `TYPE_ORDER_ID` é compatível com períodos que têm no máximo 60 dias no passado. `TYPE_AUDIENCE_COMPOSITION`, `TYPE_INVENTORY_AVAILABILITY` e `TYPE_TRUEVIEW_IAR` são compatíveis com períodos de até 30 dias atrás. . Os valores aceitáveis são os seguintes: "`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`	ID da consulta.
`reportDataEndTimeMs`	`long`	A hora de término dos dados mostrados no relatório. Observe que `reportDataEndTimeMs` será necessário se `metadata.dataRange` for `CUSTOM_DATES`. Caso contrário, será ignorado.
`reportDataStartTimeMs`	`long`	A hora de início dos dados mostrados no relatório. Observe que `reportDataStartTimeMs` será necessário se `metadata.dataRange` for `CUSTOM_DATES`. Caso contrário, será ignorado.
`schedule`	`nested object`	Informações sobre com que frequência e quando executar uma consulta.
`schedule.endTimeMs`	`long`	Data e hora de execução periódica da consulta.
`schedule.frequency`	`string`	Com que frequência a consulta é executada. Os valores aceitáveis são: "`DAILY`" "`MONTHLY`" "`ONE_TIME`" "`QUARTERLY`" "`SEMI_MONTHLY`" "`WEEKLY`"
`schedule.nextRunMinuteOfDay`	`integer`	Obsoleto. Esse campo não tem efeito.
`schedule.nextRunTimezoneCode`	`string`	Código de fuso horário canônico para o horário de geração do relatório. O valor padrão é `America/New_York`.
`timezoneCode`	`string`	Código de fuso horário canônico para a hora dos dados do relatório. O valor padrão é `America/New_York`.

Métodos

createquery: Cria uma consulta.
deletequery: Exclui uma consulta armazenada e os relatórios armazenados associados a ela.
getquery: Recupera uma consulta armazenada.
listqueries: Recupera as consultas armazenadas.
runquery (em inglês): Executa uma consulta armazenada para gerar um relatório.

Queries Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Representações de recursos

Métodos

Queries