Method: exchanges.generateReport

Generiert und gibt die Berichts-ID zurück. Der Bericht wird nicht gespeichert. Bei Aufrufen mit derselben Anfrage wird der Bericht neu generiert.

HTTP-Anfrage

POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
exchange

string

Erforderlich. Name der Börse, zu der der Bericht gehört. Beispiel: „exchanges/123“ (erforderlich)

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
Felder
startDate

string

Erforderlich. Das Startdatum der Berichte im ISO_8601-Format JJJJ-MM-TT (einschließlich). Als Eingabe erforderlich.

endDate

string

Erforderlich. Enddatum der Berichte im ISO_8601-Format JJJJ-MM-TT (einschließlich). Als Eingabe erforderlich.

reportType

enum (ReportType)

Erforderlich. Wenn der Berichtstyp nicht angegeben ist, werden Fehler zurückgegeben.

dimensionIds[]

enum (DimensionId)

Optional. Liste der Dimensionen, auf deren Grundlage der Bericht generiert wird. Wenn „null“, wird nur die Publisher-ID angegeben. Wenn die Dimensionen in einem bestimmten Berichtstyp nicht unterstützt werden, werden sie ignoriert.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Report.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ReportType"

Berichtstyp

Enums
REPORT_TYPE_UNSPECIFIED Der Berichtstyp ist nicht angegeben oder der Eingabewert ist ungültig.
HOURLY Ein stündlicher Berichtstyp.
DAILY Ein täglicher Berichtstyp.
WEEKLY Ein wöchentlicher Berichtstyp.
MONTHLY Ein monatlicher Berichtstyp.
AWBID_DAILY Ein AwBid-Tagesberichtstyp.
AWBID_WEEKLY Ein wöchentlicher Berichtstyp für AwBid.
AWBID_MONTHLY Ein monatlicher Berichtstyp für AwBid.
AWBID_OUT_OF_MONTH_IVT Ein AwBid-Berichtstyp für ungültigen Traffic im vierten Monat.

DimensionId

Enum „ReportDimensionId“.

Enums
DIMENSION_ID_UNSPECIFIED Die Berichtsdimension ist nicht angegeben oder der Eingabewert ist ungültig.
PARTNER_ID Partner-ID, wird nur im täglichen Bericht unterstützt.
DEVICE_TYPE Gerätetyp, wird nur im Tagesbericht unterstützt.
CREATIVE_ID Die Creative-ID wird nur im Tagesbericht unterstützt. Diese Dimension kann die Dateigröße der Berichte erheblich erhöhen. Berichte mit dieser Dimension können mehrere Stunden in Anspruch nehmen. In Zukunft werden wir die Bewertung dieser stark belastenden Felder einschränken.
CREATIVE_TYPE Creative-Typ, wird nur im Tagesbericht unterstützt. Diese Dimension kann die Dateigröße von Berichten erheblich beeinflussen. Die Erstellung von Berichten mit dieser Dimension kann Stunden dauern. In Zukunft werden wir die Bewertung dieser Felder mit hoher Last einschränken.
REGION_CODE Länder-/Regionscode, wird nur im Tagesbericht unterstützt.
DEAL_ID Die Deal-ID, die der Inventarquelle zugeordnet ist, wird nur im täglichen Bericht unterstützt.
PUBLISHER_ID Publisher-ID. Wenn die Liste der Eingabedimensionen-IDs null ist, ist dies die Standarddimension.