Method: adPlays.createWithExternalIds

外部 ID を使用して広告再生を作成します。

  • 成功した場合は、新しく作成された広告再生を返します。
  • 無効な広告ユニットの外部 ID、オーダーの外部 ID、広告申込情報の外部 ID、またはクリエイティブ アセットの外部 ID が指定されている場合は、エラーコード INVALID_ARGUMENT を返します。
  • 同じ広告ユニット、オーダー、行、クリエイティブに対して、同じ startTime の広告がすでに再生されている場合、エラーコード INVALID_ARGUMENT を返します。
  • 一致する広告ユニットの外部 ID、オーダーの外部 ID、広告申込情報の外部 ID、またはクリエイティブ アセットの外部 ID が見つからない場合は、エラーコード NOT_FOUND を返します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
フィールド
lineExternalId

string

必須。この広告再生が属する行の外部 ID。形式: 123。
orderExternalId

string

必須。この広告再生が属する注文の外部 ID。形式: 456。
adUnitExternalId

string

必須。この広告再生が配信された広告ユニットの外部 ID。形式: 789。
creativeAssetExternalId

string

必須。この広告再生が配信されたクリエイティブの外部 ID。形式: 3210。
startTime

string (Timestamp format)

必須。広告の再生が開始された時刻（両端を含む）。過去 3 日以内の日付を指定する必要があります。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
endTime

string (Timestamp format)

必須。広告の再生が終了した時間（この時間を含まない）。過去の日時で、開始時間より後の日時にする必要があります。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
recordTime

string (Timestamp format)

省略可。この広告再生が記録された時刻。過去の時刻より後の時刻を指定してください。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
impressions

number

必須。インプレッションの合計数。

レスポンスの本文

成功した場合、レスポンスの本文には AdPlay のインスタンスが含まれます。

承認スコープ

次の OAuth スコープが必要です。

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

詳しくは、OAuth 2.0 の概要をご覧ください。