Method: orders.lines.reserve

既存の回線を予約します。

  • 成功した場合は、更新された行を返します。
  • 行が存在しない場合はエラーコード NOT_FOUND を返します。
  • lineTerms が設定されていない場合、エラーコード INVALID_ARGUMENT を返します。
  • lineState が LINE_STATE_PENDING_RESERVATION でない場合、エラーコード FAILED_PRECONDITION を返します。

HTTP リクエスト

POST https://dv360outofhomeseller.googleapis.com/v1beta1/{name=orders/*/lines/*}:reserve

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

パスパラメータ

パラメータ
name

string

このフィールドには、予約する行の名前が含まれます(例: 「orders/123/lines/321」)。

リクエスト本文

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

JSON 表現
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
フィールド
lineTerms

object (LineTerms)

必須。この広告申込情報の販売者保証の利用規約。

reservationExpirationTime

string (Timestamp format)

必須。予約の有効期限のタイムスタンプ。購入者は、予約が期限切れになる前に予約する必要があります。

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

レスポンスの本文

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

承認スコープ

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

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

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