Method: adPlays.createWithExternalIds

Harici kimliklerle bir reklam oynatma oluşturur.

  • Başarılıysa, yeni oluşturulan reklamı döndürür.
  • Geçersiz reklam birimi harici kimliği, sipariş harici kimliği, satır harici kimliği veya reklam öğesi harici kimliği 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 INVALID_ARGUMENT hata kodunu döndürür.
  • Eşleşen reklam birimi harici kimliği, sipariş harici kimliği, satır harici kimliği veya reklam öğesi harici kimliği bulunamazsa NOT_FOUND hata kodunu döndürür.

HTTP isteği

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

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

İstek içeriği

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

JSON gösterimi 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
Alanlar
lineExternalId

string

Zorunlu. Bu reklamın ait olduğu satırın harici kimliği. Biçim: 123.
orderExternalId

string

Zorunlu. Bu reklamın oynatıldığı siparişin harici kimliği. Biçim: 456.
adUnitExternalId

string

Zorunlu. Bu reklamın oynatıldığı reklam biriminin harici kimliği. Biçim: 789.
creativeAssetExternalId

string

Zorunlu. Bu reklam oynatmanın yayınladığı reklam öğesinin harici kimliği. Biçim: 3210.
startTime

string (Timestamp format)

Zorunlu. Reklamın oynatılmaya başladığı zaman (dahil). Geçmişte ve son 3 gün içinde olmalıdır.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Zorunlu. Reklam oynatmanın sona erdiği zaman (hariç). Başlangıç zamanı geçmişte ve sonrasında olmalıdır.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

İsteğe bağlı. Bu reklam oynatmanın kaydedildiği zaman. Bitiş zamanında ve sonrasında olmalıdır.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
impressions

number

Zorunlu. Toplam gösterim sayısı.

Yanıt gövdesi

Başarılıysa yanıt metni, AdPlay öğesinin bir örneğini içerir.

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.