Method: exchanges.generateReport

Generuje i zwraca identyfikator raportu. Raport nie jest zachowywany. Wywołania z tym samym żądaniem spowoduje ponowne wygenerowanie raportu.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
exchange

string

Wymagane. Nazwa giełdy, do której należy raport. Przykład: „giełdy/123” Wymagana.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
Pola
startDate

string

Wymagane. Data rozpoczęcia raportów w formacie ISO_8601 RRRR-MM-DD włącznie. Wymagane jako dane wejściowe.
endDate

string

Wymagane. Data zakończenia raportów w formacie ISO_8601 RRRR-MM-DD włącznie. Wymagane jako dane wejściowe.
reportType

enum (ReportType)

Wymagane. Jeśli nie podasz typu raportu, zostaną zwrócone błędy.
dimensionIds[]

enum (DimensionId)

Opcjonalnie: Lista wymiarów, na których podstawie zostanie wygenerowany raport. Jeśli wartość to null, uwzględnij tylko identyfikator wydawcy. Jeśli dany typ raportu nie obsługuje wymiarów, zostaną zignorowane.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Report.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ReportType

Typ raportu.

Wartości w polu enum
REPORT_TYPE_UNSPECIFIED Nieokreślony typ raportu, nieprawidłowa wartość wejściowa
HOURLY Typ raportu godzinowego.
DAILY Codziennie.
WEEKLY Typ raportu tygodniowego.
MONTHLY Raport miesięczny.

DimensionId

Podaj wyliczenie identyfikatora wymiaru.

Wartości w polu enum
DIMENSION_ID_UNSPECIFIED Nieokreślony wymiar raportu. Nieprawidłowa wartość wejściowa.
PARTNER_ID Identyfikator partnera, obsługiwany tylko w raporcie dziennym.
DEVICE_TYPE Typ urządzenia – obsługiwany tylko w raporcie dziennym.
CREATIVE_ID Identyfikator kreacji, obsługiwany tylko w raporcie dziennym. Pamiętaj, że ten wymiar może znacząco zwiększyć rozmiar plików raportów. Generowanie raportów zawierających ten wymiar może potrwać kilka godzin. W przyszłości ograniczymy ocenę w przypadku tych pól wymagających dużych nakładów pracy.
CREATIVE_TYPE Typ kreacji obsługiwany tylko w raporcie dziennym. Pamiętaj, że ten wymiar może znacząco zwiększyć rozmiar plików raportów. Generowanie raportów zawierających ten wymiar może potrwać kilka godzin. W przyszłości ograniczymy ocenę w przypadku tych pól wymagających dużych nakładów pracy.
REGION_CODE Kod kraju/regionu obsługiwany tylko w raporcie dziennym.
DEAL_ID Identyfikator umowy, mapowany na źródło zasobów reklamowych, obsługiwany tylko w raporcie dziennym.
PUBLISHER_ID Identyfikator wydawcy: jeśli lista identyfikatorów wymiaru wejściowego ma wartość null, jest to wymiar domyślny.