Method: advertisers.lineItems.generateDefault

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

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

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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
フィールド
insertionOrderId

string (int64 format)

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

string

必須。項目の表示名。

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

enum (LineItemType)

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

object (MobileApp)

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

これは、lineItemType が LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL または LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL の場合にのみ適用されます。
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

この広告申込情報で欧州連合の政治広告を配信するかどうか。

親広告主で containsEuPoliticalAds が DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING に設定されている場合、特に指定がない限り、このフィールドには DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING が割り当てられます。このフィールドは、UI、API、構造化データ ファイルを使用して更新できます。

このフィールドは、新しい広告申込情報を作成するときに割り当てる必要があります。それ以外の場合、advertisers.lineItems.create リクエストは失敗します。

レスポンスの本文

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

認可スコープ

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

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

詳細については、OAuth 2.0 Overview をご覧ください。