REST Resource: curators.reports

Ressource: Bericht

Die Report-Ressource.

JSON-Darstellung
{
  "name": string,
  "reportId": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "displayName": string,
  "updateTime": string,
  "createTime": string,
  "locale": string
}
Felder
name

string

ID. Der Ressourcenname des Berichts. Der Name der Berichtsressource hat das folgende Format: curators/{accountId}/reports/{reportId}

reportId

string (int64 format)

Nur Ausgabe. Berichts-ID.

reportDefinition

object (ReportDefinition)

Erforderlich. Die Berichtsdefinition des Berichts.

displayName

string

Optional. Anzeigename für den Bericht.

updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem dieser Bericht zuletzt geändert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem dieser Bericht erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

locale

string

Nur Ausgabe. Das Gebietsschema dieses Berichts. Die Sprache wird zum Zeitpunkt der Anfrage anhand der Sprache des Nutzers festgelegt. Die Sprache kann nicht geändert werden.

ReportDefinition

Die Definition, wie ein Bericht ausgeführt werden soll.

JSON-Darstellung
{
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "filters": [
    {
      object (Filter)
    }
  ],
  "timeZoneSource": enum (TimeZoneSource),
  "timeZone": string,
  "currencyCode": string,
  "dateRange": {
    object (DateRange)
  },
  "sorts": [
    {
      object (Sort)
    }
  ]
}
Felder
dimensions[]

enum (Dimension)

Erforderlich. Die Liste der Dimensionen, für die Berichte erstellt werden sollen. Wenn das Feld leer ist, enthält der Bericht keine Dimensionen und alle Messwerte sind Gesamtsummen.

metrics[]

enum (Metric)

Erforderlich. Die Liste der Messwerte, für die Berichte erstellt werden sollen. Wenn das Feld leer ist, enthält der Bericht keine Messwerte.

filters[]

object (Filter)

Optional. Die Filter für diesen Bericht.

timeZoneSource

enum (TimeZoneSource)

Optional. Wo Sie die Zeitzone für diesen Bericht finden. Standardmäßig wird die Zeitzone Pacific Time (PT) verwendet. Wenn die Quelle PROVIDED ist, muss im Feld „timeZone“ in der Berichtsdefinition auch eine Zeitzone festgelegt werden.

timeZone

string

Optional. Wenn „timeZoneSource“ den Wert „PROVIDED“ hat, ist dies die Zeitzone, die für diesen Bericht verwendet werden soll. Lassen Sie das Feld leer, wenn Sie eine andere Zeitzonenquelle verwenden. Zeitzone im IANA-Format. Beispiel: „America/New_York“.

currencyCode

string

Optional. Der ISO 4217-Währungscode für diesen Bericht. Wenn keine Angabe gemacht wird, wird standardmäßig der Währungscode des Kontos verwendet.

dateRange

object (DateRange)

Erforderlich. Der primäre Zeitraum dieses Berichts.

sorts[]

object (Sort)

Optional. Standardsortierungen, die auf diesen Bericht angewendet werden sollen.

Dimension

Berichtsdimensionen

Enums
DIMENSION_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
ADVERTISER_DOMAIN Die Domain des Werbetreibenden.
COUNTRY Anzeigename eines Landes.
CURATION_DATA_SEGMENT_ID Die ID des Datensegments, das von einem Kurator erstellt wurde.
CURATION_DATA_SEGMENT_RESPONSE_STATUS Der Antwortstatus der Datensegmentanfragen in der Echtzeit-Kuration. Weitere Informationen finden Sie unter https://developers.google.com/authorized-buyers/curation/get-started/start.
CURATION_DATA_SEGMENT_RESPONSE_STATUS_NAME Der lokalisierte Anzeigename des Antwortstatus der Datensegmentanfragen in der Echtzeit-Kuration. Weitere Informationen finden Sie unter https://developers.google.com/authorized-buyers/curation/get-started/start.
CURATOR_FEE_TYPE Die Art des Kuratierungsdienstes (z.B. Paket oder Datensegment).
DATE Datum.
DEAL_ID Deal-ID.
DEAL_NAME Name des Deals.
DETECTED_ADVERTISER_NAME Anzeigename des erkannten Werbetreibenden.
DSP_NAME Anzeigename der DSP.
DSP_SEAT_ID DSP-Sitz-ID.
ENVIRONMENT Das Nutzergerät und die Containerumgebung, von der die Impression stammt. Unterstützte Werte sind „app“ und „web“.
ENVIRONMENT_NAME Der lokalisierte Anzeigename des Nutzergeräts und der Containerumgebung, von der die Impression stammt. Unterstützte Werte sind „app“ und „web“.
HOLDING_COMPANY_NAME Anzeigename der Holdinggesellschaft.
HOUR Stunde.
MOBILE_APP_ID ID der mobilen App.
MOBILE_APP_NAME Name der mobilen App.
MOBILE_OS Mobiles Betriebssystem
MONTH Month.
PACKAGE_FEE_VISIBILITY Die Sichtbarkeit der Paketgebühr (z.B. offengelegt oder nicht offengelegt).
PLATFORM Plattform, z. B. „Desktop“ oder „Mobil“
PUBLISHER_DOMAIN Publisher-Domain.
PUBLISHER_ID Publisher-ID.
PUBLISHER_NAME Publisher-Name.
WEEK Woche.

Messwert

Berichtsmesswerte

Enums
METRIC_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
ACTIVE_VIEW_MEASURABILITY_RATE Rate der mit Active View messbaren Impressionen.
ACTIVE_VIEW_MEASURABLE Mit Active View messbar.
ACTIVE_VIEW_VIEWABILITY_RATE Active View-Sichtbarkeitsrate
ACTIVE_VIEW_VIEWABLE Sichtbare Impressionen (Active View)
AUCTIONS_WON Gewonnene Auktionen.
BIDS Gebote:
BIDS_IN_AUCTION Gebote in der Auktion
BID_REQUESTS Gebotsanfragen.
CLICKS Klicks:
CURATION_PARTNER_FEE Kuratierungsgebühr. Dieser Wert wird auf 0,00 gekürzt, wenn die Sichtbarkeit des Pakets auf „Nicht offengelegt“ festgelegt ist. Verwenden Sie die Dimension PACKAGE_FEE_VISIBILITY, um zu prüfen, ob die Gebühr des Pakets offengelegt wird.
DATA_SEGMENT_REQUESTS Anzahl der Datensegmentanfragen, die im Rahmen der Echtzeit-Kuration gesendet wurden.
IMPRESSIONS Impressionen:
SPEND Ausgaben in der in der Anfrage angegebenen Berichtswährung. Die Standardeinstellung ist USD.

Filter

Ein Filter für ein oder mehrere Felder.

JSON-Darstellung
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fieldFilter": {
    object (FieldFilter)
  },
  "notFilter": {
    object (Filter)
  },
  "andFilter": {
    object (FilterList)
  },
  "orFilter": {
    object (FilterList)
  }
  // End of mutually exclusive fields.
}
Felder
Der Typ bestimmt, wie die zugrunde liegenden Filter kombiniert werden. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
fieldFilter

object (FieldFilter)

Ein Filter für ein einzelnes Feld.

notFilter

object (Filter)

Ein Filter, dessen Ergebnis negiert wird.

andFilter

object (FilterList)

Eine Liste von Filtern, deren Ergebnisse mit UND verknüpft sind.

orFilter

object (FilterList)

Eine Liste von Filtern, deren Ergebnisse mit ODER verknüpft sind.

Ende der sich gegenseitig ausschließenden Felder.

FieldFilter

Ein Filter für ein bestimmtes Feld.

JSON-Darstellung
{
  "field": {
    object (Field)
  },
  "operation": enum (Operation),
  "values": [
    {
      object (ReportValue)
    }
  ]
}
Felder
field

object (Field)

Pflichtangabe. Das Feld, nach dem gefiltert werden soll.

operation

enum (Operation)

Erforderlich. Der Vorgang dieses Filters.

values[]

object (ReportValue)

Erforderlich. Werte, nach denen gefiltert werden soll.

Feld

Eine Dimension oder ein Messwert in einem Bericht.

JSON-Darstellung
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dimension": enum (Dimension),
  "metric": enum (Metric)
  // End of mutually exclusive fields.
}
Felder
Entweder eine Dimension oder ein Messwert. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
dimension

enum (Dimension)

Die Dimension, die dieses Feld darstellt.

metric

enum (Metric)

Der Messwert, den dieses Feld darstellt.

Ende der sich gegenseitig ausschließenden Felder.

Vorgang

Unterstützte Filtervorgänge.

Enums
IN

Prüft bei skalaren Operanden, ob der Operand in der Menge der angegebenen Filterwerte enthalten ist.

Bei Listenoperanden wird geprüft, ob ein Element im Operanden in der Gruppe der angegebenen Filterwerte enthalten ist.

Standardwert.

NOT_IN

Prüft bei skalaren Operanden, ob der Operand nicht in der Menge der angegebenen Filterwerte enthalten ist.

Bei Listenoperanden wird geprüft, ob keines der Elemente im Operanden in der Gruppe der angegebenen Filterwerte enthalten ist.

CONTAINS

Prüft bei skalaren Stringoperanden, ob der Operand einen der angegebenen Filterteilstrings enthält.

Bei Stringlistenoperanden wird geprüft, ob ein String im Operanden einen der angegebenen Filterteilstrings enthält.

NOT_CONTAINS

Prüft bei skalaren Stringoperanden, ob der Operand keinen der angegebenen Filter-Teilstrings enthält.

Bei Stringlistenoperanden wird geprüft, ob keiner der Strings im Operanden einen der angegebenen Filterteilstrings enthält.

LESS_THAN Der Operand ist kleiner als der angegebene Filterwert.
LESS_THAN_EQUALS Der Operand ist kleiner oder gleich dem angegebenen Filterwert.
GREATER_THAN Der Operand ist größer als der angegebene Filterwert.
GREATER_THAN_EQUALS Der Operand ist größer als der angegebene Filterwert oder stimmt genau mit ihm überein.
BETWEEN Der Operand liegt zwischen den angegebenen Filterwerten.
MATCHES Der Operand stimmt mit einem regulären Ausdruck oder einer Gruppe regulärer Ausdrücke überein (mindestens einer muss übereinstimmen).
NOT_MATCHES Der Operand stimmt nicht mit einem regulären Ausdruck oder einer Gruppe regulärer Ausdrücke überein (keiner darf übereinstimmen).

ReportValue

Stellt einen einzelnen Wert in einem Bericht dar.

JSON-Darstellung
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "intValue": string,
  "doubleValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "intListValue": {
    object (IntList)
  },
  "stringListValue": {
    object (StringList)
  },
  "doubleListValue": {
    object (DoubleList)
  },
  "bytesValue": string
  // End of mutually exclusive fields.
}
Felder
Der Wert des Felds hängt vom Datenformat des Felds ab. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
intValue

string (int64 format)

Für Ganzzahlwerte.

doubleValue

number

Für Double-Werte.

stringValue

string

Für Stringwerte.

boolValue

boolean

Für boolesche Werte.

intListValue

object (IntList)

Für Listen mit Ganzzahlwerten.

stringListValue

object (StringList)

Für Listen mit Stringwerten.

doubleListValue

object (DoubleList)

Für Listen mit doppelten Werten.

bytesValue

string (bytes format)

Für Byte-Werte.

Ein base64-codierter String.

Ende der sich gegenseitig ausschließenden Felder.

IntList

Eine Liste von Ganzzahlwerten.

JSON-Darstellung
{
  "values": [
    string
  ]
}
Felder
values[]

string (int64 format)

Die Werte

StringList

Eine Liste von Stringwerten.

JSON-Darstellung
{
  "values": [
    string
  ]
}
Felder
values[]

string

Die Werte

DoubleList

Eine Liste mit Double-Werten.

JSON-Darstellung
{
  "values": [
    number
  ]
}
Felder
values[]

number

Die Werte

FilterList

Eine Liste von Filtern.

JSON-Darstellung
{
  "filters": [
    {
      object (Filter)
    }
  ]
}
Felder
filters[]

object (Filter)

Erforderlich. Eine Liste von Filtern.

TimeZoneSource

Die Quelle, anhand der die Zeitzone für den Bericht bestimmt wird.

Enums
TIME_ZONE_SOURCE_UNSPECIFIED Nicht angegebener Standardwert.
AD_EXCHANGE Verwenden Sie die Zeitzone Pacific Time(PT).
UTC Verwenden Sie die UTC-Zeitzone.
PROVIDED Verwenden Sie die im Feld „ReportDefinition.time_zone“ angegebene Zeitzone. Die Ausführung von Berichten kann länger dauern, da die Datumsangaben zum Zeitpunkt der Anfrage dynamisch berechnet werden.
CURATOR Verwenden Sie die Zeitzone aus den Kontoeinstellungen des Kurators.

DateRange

Ein Zeitraum für einen Bericht.

JSON-Darstellung
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixed": {
    object (FixedDateRange)
  },
  "relative": enum (RelativeDateRange)
  // End of mutually exclusive fields.
}
Felder
Entweder ein fester oder ein relativer Zeitraum. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
fixed

object (FixedDateRange)

Ein fester Zeitraum.

relative

enum (RelativeDateRange)

Ein relativer Zeitraum.

Ende der sich gegenseitig ausschließenden Felder.

FixedDateRange

Ein Zeitraum zwischen zwei festen Datumsangaben (einschließlich Enddatum).

JSON-Darstellung
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Felder
startDate

object (Date)

Erforderlich. Das Startdatum dieses Zeitraums.

endDate

object (Date)

Erforderlich. Das Enddatum (einschließlich) dieses Zeitraums.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:

  • Ein ganzes Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind
  • Einen Monat und einen Tag mit einem Jahr von 0 (z. B. einen Jahrestag)
  • Ein Jahr für sich allein, also mit einem Monat und einem Tag von 0
  • Ein Jahr und einen Monat mit einem Tag von 0 (z. B. ein Ablaufdatum der Kreditkarte)

Ähnliche Typen:

JSON-Darstellung
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahreszahl angegeben wird.

month

integer

Monat eines Jahres. Der Wert muss zwischen 1 und 12 liegen. Er kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.

day

integer

Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Er kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht relevant ist.

RelativeDateRange

Optionen für relative Zeiträume.

Enums
RELATIVE_DATE_RANGE_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
TODAY Das Datum, an dem der Bericht erstellt wurde.
YESTERDAY Der Tag vor dem Datum, an dem der Bericht erstellt wird.
THIS_WEEK_TO_DATE Vom Beginn der Kalenderwoche bis einschließlich des Tages, an dem der Bericht erstellt wird.
THIS_WEEK_TO_YESTERDAY Vom Beginn der Kalenderwoche, in der der Bericht ausgeführt wird, bis einschließlich des Tages vor der Ausführung des Berichts.
THIS_MONTH_TO_DATE Vom Beginn des Kalendermonats, in dem der Bericht ausgeführt wird, bis einschließlich des Tages, an dem der Bericht ausgeführt wird.
THIS_MONTH_TO_YESTERDAY Vom Beginn des Kalendermonats, in dem der Bericht ausgeführt wird, bis einschließlich des Tages vor der Ausführung des Berichts.
THIS_QUARTER_TO_DATE Vom Beginn des Kalendervierteljahres, in dem der Bericht erstellt wird, bis einschließlich des Tages, an dem der Bericht erstellt wird.
THIS_QUARTER_TO_YESTERDAY Vom Beginn des Kalenderquartals, in dem der Bericht erstellt wird, bis einschließlich des Tages vor der Erstellung des Berichts.
THIS_YEAR_TO_DATE Vom Beginn des Kalenderjahres, in dem der Bericht erstellt wird, bis einschließlich des Tages, an dem der Bericht erstellt wird.
THIS_YEAR_TO_YESTERDAY Vom Beginn des Kalenderjahres, in dem der Bericht erstellt wird, bis einschließlich des Tages vor der Erstellung des Berichts.
LAST_WEEK Die gesamte vorherige Kalenderwoche, Montag bis Sonntag (einschließlich), vor der Kalenderwoche, in der der Bericht ausgeführt wird.
LAST_WEEK_STARTING_SUNDAY Die gesamte vorherige Kalenderwoche, Sonntag bis Samstag (einschließlich), vor der Kalenderwoche, in der der Bericht ausgeführt wird.
LAST_MONTH Der gesamte Kalendermonat vor dem Kalendermonat, in dem der Bericht erstellt wird.
LAST_QUARTER Das gesamte vorherige Kalendervierteljahr, das dem Kalendervierteljahr vorausgeht, in dem der Bericht ausgeführt wird.
LAST_YEAR Das gesamte Kalenderjahr vor dem Kalenderjahr, in dem der Bericht erstellt wird.
LAST_7_DAYS Die 7 Tage vor dem Tag, an dem der Bericht erstellt wird.
LAST_30_DAYS Die 30 Tage vor dem Tag, an dem der Bericht erstellt wird.
LAST_60_DAYS Die 60 Tage vor dem Tag, an dem der Bericht erstellt wird.
LAST_90_DAYS Die 90 Tage vor dem Tag, an dem der Bericht erstellt wird.
LAST_93_DAYS Die 93 Tage vor dem Tag, an dem der Bericht erstellt wird.
LAST_180_DAYS Die 180 Tage vor dem Tag, an dem der Bericht erstellt wird.
LAST_360_DAYS Die 360 Tage vor dem Tag, an dem der Bericht erstellt wird.
LAST_365_DAYS Die 365 Tage vor dem Tag, an dem der Bericht erstellt wird.
LAST_3_MONTHS Die gesamten drei Kalendermonate vor dem Kalendermonat, in dem der Bericht erstellt wird.
LAST_6_MONTHS Die gesamten sechs Kalendermonate vor dem Kalendermonat, in dem der Bericht erstellt wird.
LAST_12_MONTHS Die gesamten 12 Kalendermonate vor dem Kalendermonat, in dem der Bericht erstellt wird.
ALL_AVAILABLE Von 3 Jahren vor der Berichterstellung bis zum Tag vor der Berichterstellung (einschließlich).

Sortieren

Stellt eine Sortierung in einem Bericht dar.

JSON-Darstellung
{
  "field": {
    object (Field)
  },
  "descending": boolean
}
Felder
field

object (Field)

Erforderlich. Ein Feld (Dimension oder Messwert), nach dem sortiert werden soll.

descending

boolean

Optional. Die Sortierreihenfolge. Bei „true“ wird absteigend sortiert.

Methoden

create

Erstellt ein Report-Objekt.

delete

Löscht ein Report-Objekt.

get

Ruft ein Report-Objekt ab.

list

Listet Report-Objekte auf.

patch

Aktualisiert ein Report-Objekt.

run

Initiiert die asynchrone Ausführung eines vorhandenen Berichts.