Method: advertisers.lineItems.generateDefault

広告掲載オーダーから継承した設定(ターゲティングを含む)と ENTITY_STATUS_DRAFT entityStatus を使用して、新しい広告申込情報を作成します。成功した場合は、新しく作成された広告申込情報を返します。次の 3 つのフィールドに基づくデフォルト値があります。

YouTube /パートナーの広告申込情報は、API を使用して作成または更新できません。

HTTP リクエスト

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:generateDefault

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

パスパラメータ

パラメータ
advertiserId

string (int64 format)

必須。この広告申込情報が属する広告主の ID。

リクエスト本文

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

JSON 表現
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
フィールド
insertionOrderId

string (int64 format)

必須。広告申込情報が属する広告掲載オーダーの一意の ID。

displayName

string

必須。広告申込情報の表示名。

UTF-8 でエンコードし、最大サイズを 240 バイトにする必要があります。

lineItemType

enum (LineItemType)

必須。広告申込情報のタイプ。

mobileApp

object (MobileApp)

広告申込情報で宣伝するモバイルアプリ。

これは、lineItemTypeLINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL または LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL の場合にのみ適用されます。

レスポンスの本文

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

認可スコープ

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

  • https://www.googleapis.com/auth/display-video

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