Method: sellers.adPlays.batchCreate

Yeni reklamları toplu olarak oynatır.

  • Bir grupta izin verilen maksimum reklam oynatma sayısı 1.000'dir.
  • Başarılıysa, yeni oluşturulan reklamı döndürür.
  • Geçersiz reklam birimi, sipariş, satır veya reklam öğesi belirtilirse INVALID_ARGUMENT hata kodunu döndürür.
  • Aynı reklam birimi, sipariş, satır ve reklam öğesi için aynı startTime'a sahip bir reklam oynatma zaten varsa ALREADY_EXISTS hata kodunu döndürür.
  • Eşleşen reklam birimi, sipariş, satır veya reklam öğesi bulunamazsa NOT_FOUND hata kodunu döndürür.
  • İstek hem kaynak adı hem de harici kimlik içeriyorsa FAILED_PRECONDITION hata kodunu döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Satıcı kaynak adı. Biçim: sellers/{seller}

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "requests": [
    {
      object (CreateAdPlayRequest)
    }
  ]
}
Alanlar
requests[]

object (CreateAdPlayRequest)

Zorunlu. Reklam, oluşturmak için oynatılır.

Bir grupta izin verilen maksimum reklam oynatma sayısı 1.000'dir. Başlangıç zamanı geçmişte ve oluşturma tarihinden en fazla 3 gün önce olmalıdır. Bitiş zamanı, başlangıç zamanından ve bu saatten sonra olmalıdır.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Reklam oynatmaları toplu olarak oluşturma yanıtı.

JSON gösterimi 
{
  "adPlays": [
    {
      object (AdPlay)
    }
  ]
}
Alanlar
adPlays[]

object (AdPlay)

Oluşturulan reklam oynatılır.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

CreateAdPlayRequest

AdPlayService.CreateAdPlay için istek mesajı.

JSON gösterimi 
{
  "parent": string,
  "adPlay": {
    object (AdPlay)
  }
}
Alanlar
parent

string

Zorunlu. Satıcı kaynak adı. Biçim: sellers/{seller}
adPlay

object (AdPlay)

Zorunlu. Oluşturulacak reklam.

Reklam oynatma adı sistem tarafından oluşturulur ve ayarlanmamalıdır. Başlangıç zamanı geçmişte ve oluşturma tarihinden en fazla 3 gün önce olmalıdır. Bitiş zamanı, başlangıç zamanından ve bu saatten sonra olmalıdır.