Queries

Listę metod, które odnoszą się do tego zasobu, znajdziesz na końcu tej strony.

Reprezentacje zasobów

Reprezentuje zapytanie.

{
  "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
}
Nazwa usługi, Wartość Opis Uwagi
kind string Określa rodzaj tego zasobu. Wartość: ustalony ciąg znaków "doubleclickbidmanager#query".
metadata nested object Metadane zapytania.
metadata.dataRange string Zakres danych raportu.

Akceptowane wartości:
  • „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 Format wygenerowanego raportu.

Akceptowane wartości:
  • „CSV”
  • „EXCEL_CSV”
  • „XLSX”
metadata.googleCloudStoragePathForLatestReport string Ścieżka do lokalizacji w Google Cloud Storage, w której jest przechowywany ostatni raport.
metadata.googleDrivePathForLatestReport string Ścieżka na Dysku Google do ostatniego raportu.
metadata.latestReportRunTimeMs long Czas rozpoczęcia ostatniego raportu.
metadata.locale string

Język wygenerowanych raportów. Akceptowane wartości:

  • „cs” za czeski
  • „de” dla Niemiec
  • „en” – ENGLISH
  • „es” dla SPANISH
  • „fr” jako francuski
  • „it” dla języka włoskiego
  • „ja” w języku japońskim
  • „ko” dla KOREAN
  • „pl” dla POLISH
  • „pt-BR” dla BRAZILIAN_PORTUGUESE
  • „ru” dla RUSSIAN
  • „tr” dla tureckiego
  • „uk” – Wielka Brytania
  • „zh-CN” dla CHINA_CHINESE
  • „zh-TW” dla TAIWAN_CHINESE

Ciąg lokalny, którego nie ma na liście powyżej, będzie generować raporty w języku angielskim.
metadata.reportCount integer Liczba raportów wygenerowanych dla danego zapytania.
metadata.running boolean Czy generowany jest najnowszy raport.
metadata.sendNotification boolean Określa, czy wysłać e-maila z powiadomieniem o gotowości raportu. Wartość domyślna to fałsz.
metadata.shareEmailAddress[] list Lista adresów e-mail, na które są wysyłane powiadomienia e-mail o zakończeniu tworzenia raportu. Oddziel od sendNotification.
metadata.title string Tytuł zapytania. Służy do nadawania nazw raportom wygenerowanym przez to zapytanie.
params nested object parametry zapytania.
params.filters[] list Filtry używane do dopasowywania danych o ruchu w raporcie.
params.filters[].type string Typ filtra.

Akceptowane wartości:
  • „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 Wartość filtra.
params.groupBys[] list Dane są grupowane według filtrów wymienionych w tym polu.
params.includeInviteData boolean Rola wycofana. To pole nie jest już używane.
params.metrics[] list Dane, które mają być uwzględnione w raporcie jako kolumny.
params.type string Typ raportu.

Ograniczenia specyficzne dla typu:
  • TYPE_ORDER_ID obsługuje zakresy dat nie starsze niż 60 dni.
  • Obsługiwane zakresy dat pomocy: TYPE_AUDIENCE_COMPOSITION, TYPE_INVENTORY_AVAILABILITY, TYPE_TRUEVIEW_IAR – maksymalnie 30 dni wcześniej.


Akceptowane wartości:
  • „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 Identyfikator zapytania.
reportDataEndTimeMs long Data końcowa danych wyświetlanych w raporcie. Pamiętaj, że właściwość reportDataEndTimeMs jest wymagana, jeśli metadata.dataRange ma wartość CUSTOM_DATES, a w przeciwnym razie jest ignorowana.
reportDataStartTimeMs long Godzina rozpoczęcia wyświetlania danych w raporcie. Pamiętaj, że właściwość reportDataStartTimeMs jest wymagana, jeśli metadata.dataRange ma wartość CUSTOM_DATES, a w przeciwnym razie jest ignorowana.
schedule nested object Informacje o tym, jak często i kiedy uruchamiać zapytanie.
schedule.endTimeMs long Datetime, aby okresowo uruchamiać zapytanie.
schedule.frequency string Częstotliwość wykonywania zapytania.

Akceptowane wartości:
  • „DAILY”
  • „MONTHLY”
  • „ONE_TIME”
  • „QUARTERLY”
  • „SEMI_MONTHLY”
  • „WEEKLY”
schedule.nextRunMinuteOfDay integer Rola wycofana. To pole nie ma żadnego efektu.
schedule.nextRunTimezoneCode string Kanoniczny kod strefy czasowej generowania raportu. Domyślna wartość to America/New_York.
timezoneCode string Kanoniczny kod strefy czasowej danych raportowania. Domyślna wartość to America/New_York.

Metody

createquery
Tworzy zapytanie.
usuń zapytanie
Usuwa zapisane zapytanie oraz powiązane z nimi raporty.
Pobierz zapytanie
Pobiera zapisane zapytanie.
listy
Pobiera zapisane zapytania.
runquery
Generuje zapisane zapytanie, aby wygenerować raport.