Method: exchanges.generateReport

Generuje i zwraca identyfikator raportu. Raport nie jest zapisywany. Wywołania z tym samym żądaniem spowodują 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żą raporty. Przykład: „exchanges/123” Wymagane.

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. Typ raportu. Jeśli nie zostanie określony, zostaną zwrócone błędy.
dimensionIds[]

enum (DimensionId)

Opcjonalnie. Lista wymiarów, na podstawie których zostanie wygenerowany raport. Jeśli wartość jest null, uwzględnij tylko identyfikator wydawcy. Jeśli wymiary nie są obsługiwane w określonym typie raportu, 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 OAuth 2.0 Overview.

ReportType

Typ raportu.

Wartości w polu enum
REPORT_TYPE_UNSPECIFIED Typ raportu nieokreślony, nieprawidłowa wartość wejściowa.
HOURLY Typ raportu godzinowego.
DAILY Typ raportu dziennego.
WEEKLY Typ raportu tygodniowego.
MONTHLY Typ raportu miesięcznego.
AWBID_DAILY Typ raportu dziennego AwBid.
AWBID_WEEKLY Typ raportu tygodniowego AwBid.
AWBID_MONTHLY Typ raportu miesięcznego AwBid.
AWBID_OUT_OF_MONTH_IVT Typ raportu AwBid dotyczącego nieprawidłowego ruchu z poprzedniego miesiąca.

DimensionId

Wyliczenie DimensionId raportu.

Wartości w polu enum
DIMENSION_ID_UNSPECIFIED Wymiar raportu nieokreślony, 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 pliku raportów. Uruchomienie raportów zawierających ten wymiar może potrwać kilka godzin. W przyszłości ograniczymy ocenę tych pól o dużym obciążeniu.
CREATIVE_TYPE Typ kreacji, obsługiwany tylko w raporcie dziennym. Pamiętaj, że ten wymiar może znacząco zwiększyć rozmiar pliku raportów. Uruchomienie raportów zawierających ten wymiar może potrwać kilka godzin. W przyszłości ograniczymy ocenę tych pól o dużym obciążeniu.
REGION_CODE Kod kraju/regionu, obsługiwany tylko w raporcie dziennym.
DEAL_ID Identyfikator umowy, mapowanie do źródła zasobów reklamowych, obsługiwane tylko w raporcie dziennym.
PUBLISHER_ID Identyfikator wydawcy. Jeśli lista identyfikatorów wymiarów wejściowych ma wartość null, jest to domyślny wymiar.