Method: adPlays.createWithExternalIds

Tworzy odtworzenie reklamy z zewnętrznymi identyfikatorami.

  • Zwraca nowo utworzone odtworzenie reklamy, jeśli operacja się uda.
  • Zwraca kod błędu INVALID_ARGUMENT, jeśli podano nieprawidłowy identyfikator zewnętrzny jednostki reklamowej, zewnętrzny identyfikator zamówienia, zewnętrzny identyfikator wiersza lub zewnętrzny identyfikator komponentu kreacji.
  • Zwraca kod błędu INVALID_ARGUMENT, jeśli istnieje już odtworzenie reklamy o tej samej jednostce reklamowej, zamówieniu, wierszu i kreacji o tym samym czasie rozpoczęcia.
  • W przypadku braku pasującego zewnętrznego identyfikatora jednostki reklamowej, zewnętrznego identyfikatora zamówienia, zewnętrznego identyfikatora wiersza lub zewnętrznego identyfikatora komponentu kreacji zwraca kod błędu NOT_FOUND.

Żądanie HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

Adres URL używa składni transkodowania gRPC.

Treść żądania

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

Zapis JSON 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
Pola
lineExternalId

string

Wymagane. Zewnętrzny identyfikator wiersza, do którego należy to odtworzenie reklamy. Format: 123.
orderExternalId

string

Wymagane. Zewnętrzny identyfikator zamówienia, do którego należy to odtworzenie reklamy. Format: 456.
adUnitExternalId

string

Wymagane. Zewnętrzny identyfikator jednostki reklamowej, w której to odtworzenie reklamy zostało wyświetlone. Format: 789.
creativeAssetExternalId

string

Wymagane. Zewnętrzny identyfikator kreacji wyświetlonej przez tę reklamę. Format: 3210.
startTime

string (Timestamp format)

Wymagane. Godzina rozpoczęcia odtwarzania reklamy (włącznie). Powinna przypadać w przeszłości i w ciągu ostatnich 3 dni.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Wymagane. Czas zakończenia odtwarzania reklamy (z wyłączeniem). Musi przypadać w przeszłości i po godzinie rozpoczęcia.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

Opcjonalnie: Czas zarejestrowania tej reklamy. Musi przypadać w przeszłości i po godzinie zakończenia.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
impressions

number

Wymagane. Łączna liczba wyświetleń.

Treść odpowiedzi

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

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.