Queries

Diese Version der Bid Manager API wurde eingestellt. Nutzer müssen die Bid Manager API Version 2 verwenden.

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Stellt eine Abfrage dar.

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

Property-Name	Wert	Beschreibung	Hinweise
kind	string	Gibt an, um welche Art von Ressource es sich handelt. Wert: der feste String "doubleclickbidmanager#query".
metadata	nested object	Abfragemetadaten.
metadata.dataRange	string	Bereich der Berichtsdaten. Zulässige Werte sind: <ph type="x-smartling-placeholder"> </ph> „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 des erstellten Berichts. Zulässige Werte sind: <ph type="x-smartling-placeholder"> </ph> „CSV“ „EXCEL_CSV“ „XLSX“
metadata.googleCloudStoragePathForLatestReport	string	Der Pfad zum Speicherort in Google Cloud Storage, an dem der neueste Bericht gespeichert ist.
metadata.googleDrivePathForLatestReport	string	Der Pfad in Google Drive für den neuesten Bericht.
metadata.latestReportRunTimeMs	long	Der Zeitpunkt, zu dem die Ausführung des letzten Berichts gestartet wurde.
metadata.locale	string	Sprache der generierten Berichte. Akzeptable Werte sind: „cs“ für TSCHECHIEN „de“ für DEUTSCH „en“ für ENGLISH „es“ für SPANISH „fr“ für FRANZÖSISCH „it“ für Italienisch „ja“ für JAPANISCH „ko“ für KOREAN „pl“ für POLISCH „pt-BR“ für BRAZILIAN_PORTUGUESE „ru“ für RUSSISCH „tr“ für TURKISH „uk“ für UKRAINIAN „zh-CN“ für CHINA_CHINESE „zh-TW“ für TAIWAN_CHINESE Eine Gebietsschemazeichenfolge, die nicht in der obigen Liste enthalten ist, generiert Berichte auf Englisch.
metadata.reportCount	integer	Anzahl der Berichte, die für die Abfrage generiert wurden.
metadata.running	boolean	Ob der neueste Bericht derzeit ausgeführt wird
metadata.sendNotification	boolean	Gibt an, ob eine E-Mail-Benachrichtigung gesendet werden soll, wenn ein Bericht fertig ist. Die Standardeinstellung ist „false“.
metadata.shareEmailAddress[]	list	Liste der E-Mail-Adressen, an die nach Abschluss des Berichts E-Mail-Benachrichtigungen gesendet werden. Getrennt von sendNotification.
metadata.title	string	Titel der Abfrage. Damit werden die über diese Abfrage generierten Berichte benannt.
params	nested object	Abfrageparameter:
params.filters[]	list	Filter, mit denen Traffic-Daten in Ihrem Bericht abgeglichen werden.
params.filters[].type	string	Filtertyp. Zulässige Werte sind: <ph type="x-smartling-placeholder"> </ph> „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	Filterwert.
params.groupBys[]	list	Die Daten werden anhand der in diesem Feld aufgeführten Filter gruppiert.
params.includeInviteData	boolean	Verworfen. Dieses Feld wird nicht mehr verwendet.
params.metrics[]	list	Messwerte, die als Spalten in Ihren Bericht aufgenommen werden sollen.
params.type	string	Berichtstyp. Typspezifische Einschränkungen: TYPE_ORDER_ID unterstützt Zeiträume, die maximal 60 Tage in der Vergangenheit liegen. Für TYPE_AUDIENCE_COMPOSITION, TYPE_INVENTORY_AVAILABILITY und TYPE_TRUEVIEW_IAR werden Zeiträume unterstützt, die maximal 30 Tage in der Vergangenheit liegen. Zulässige Werte sind: <ph type="x-smartling-placeholder"> </ph> „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	Abfrage-ID.
reportDataEndTimeMs	long	Die Endzeit für die Daten, die im Bericht angezeigt werden. Hinweis: reportDataEndTimeMs ist erforderlich, wenn metadata.dataRange den Wert CUSTOM_DATES hat. Andernfalls wird die Variable ignoriert.
reportDataStartTimeMs	long	Die Startzeit für die Daten, die im Bericht angezeigt werden. Hinweis: reportDataStartTimeMs ist erforderlich, wenn metadata.dataRange den Wert CUSTOM_DATES hat. Andernfalls wird die Variable ignoriert.
schedule	nested object	Informationen dazu, wie oft und wann eine Abfrage ausgeführt werden soll.
schedule.endTimeMs	long	Datetime, bis zu der die Abfrage regelmäßig ausgeführt werden soll.
schedule.frequency	string	Wie oft die Abfrage ausgeführt wird. Zulässige Werte sind: <ph type="x-smartling-placeholder"> </ph> „DAILY“ „MONTHLY“ „ONE_TIME“ „QUARTERLY“ „SEMI_MONTHLY“ „WEEKLY“
schedule.nextRunMinuteOfDay	integer	Verworfen. Dieses Feld hat keine Auswirkung.
schedule.nextRunTimezoneCode	string	Kanonischer Zeitzonencode für den Zeitpunkt der Berichterstellung. Die Standardeinstellung ist America/New_York.
timezoneCode	string	Kanonischer Zeitzonencode für die Zeit von Berichtsdaten Die Standardeinstellung ist America/New_York.

Methoden

createquery

Erstellt eine Abfrage.

deletequery

Löscht eine gespeicherte Abfrage und die zugehörigen gespeicherten Berichte.

getquery

Ruft eine gespeicherte Abfrage ab.

listqueries

Ruft gespeicherte Abfragen ab.

Runquery

Führt eine gespeicherte Abfrage aus, um einen Bericht zu generieren.