Method: sellers.adPlays.batchCreate

Zbiorczo tworzy nowe odtworzenia reklam.

  • Maksymalna dozwolona liczba odtworzeń reklam w grupie to 1000.
  • Zwraca nowo utworzoną reklamę, jeśli operacja się uda.
  • Zwraca kod błędu INVALID_ARGUMENT, jeśli określono nieprawidłowe jednostkę reklamową, zamówienie, wiersz lub kreację.
  • Zwraca kod błędu ALREADY_EXISTS, jeśli istnieje już odtworzenie reklamy o tej samej jednostce reklamowej, zamówieniu, wierszu i kreacji o tym samym czasie rozpoczęcia.
  • Jeśli nie znaleziono pasującej jednostki reklamowej, zamówienia, wiersza lub komponentu kreacji, zwraca kod błędu NOT_FOUND.
  • Zwraca kod błędu FAILED_PRECONDITION, jeśli żądanie zawiera zarówno nazwę zasobu, jak i identyfikator zewnętrzny.

Żądanie HTTP

POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays:batchCreate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Nazwa zasobu sprzedawcy. Format: sellers/{seller}

Treść żądania

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

Zapis JSON 
{
  "requests": [
    {
      object (CreateAdPlayRequest)
    }
  ]
}
Pola
requests[]

object (CreateAdPlayRequest)

Wymagane. Reklama jest odtwarzana w celu utworzenia.

Maksymalna dozwolona liczba odtworzeń reklam w grupie to 1000. Data rozpoczęcia powinna przypadać w przeszłości i nie później niż 3 dni przed datą utworzenia. Godzina zakończenia musi przypadać w przeszłości i po godzinie rozpoczęcia.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Odpowiedź dotycząca zbiorczego tworzenia odtworzeń reklam.

Zapis JSON 
{
  "adPlays": [
    {
      object (AdPlay)
    }
  ]
}
Pola
adPlays[]

object (AdPlay)

Odtworzenia reklamy, które zostały utworzone.

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.

CreateAdPlayRequest

Prośba o wiadomość dotyczącą AdPlayService.CreateAdPlay.

Zapis JSON 
{
  "parent": string,
  "adPlay": {
    object (AdPlay)
  }
}
Pola
parent

string

Wymagane. Nazwa zasobu sprzedawcy. Format: sellers/{seller}
adPlay

object (AdPlay)

Wymagane. Odtworzenie reklamy.

Nazwa odtwarzania reklamy zostanie wygenerowana przez system i nie należy jej ustawiać. Data rozpoczęcia powinna przypadać w przeszłości i nie później niż 3 dni przed datą utworzenia. Godzina zakończenia musi przypadać w przeszłości i po godzinie rozpoczęcia.