リリースノート

このページでは、ディスプレイ &ビデオ 360 のVideo 360 API。

最新の API バージョン: v3

2024 年 7 月 15 日

新機能

広告申込情報と広告グループの構造化データファイルのダウンロードがサポートされるようになりました。 v3 の QA 形式。

v3

  • 以下のフィールドが追加されました。

    リソースフィールド
    IdFilter

    adGroupQaIds

    lineItemQaIds

  • 次の列挙値が追加されました。

    列挙型値
    FileType

    FILE_TYPE_AD_GROUP_QA

    FILE_TYPE_LINE_ITEM_QA

2024 年 6 月 17 日

新機能

広告主レベルで割り当てられたキーワード ターゲティングの管理がサポートされるようになりました。

新しい optimizationObjective フィールドを広告掲載オーダーに追加しました リソースです。optimizationObjective は許可リストに登録されたお客様のみがご利用いただけます。

v3

v2

2024 年 5 月 30 日

新機能

構造化データファイル（SDF）バージョン 7.1 がサポートされるようになりました。

v3

  • 次の列挙値が追加されました。

    列挙型値
    SdfVersion

    SDF_VERSION_7_1

v2

  • 次の列挙値が追加されました。

    列挙型値
    SdfVersion

    SDF_VERSION_7_1

2024 年 4 月 23 日

新機能

新しい KPI タイプ、エクスチェンジ、アプリ プラットフォームのサポートを追加しました。

v3

  • 以下のフィールドが追加されました。

    リソースフィールド
    KPI

    kpiAlgorithmId

  • 次の列挙値が追加されました。

    列挙型値
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV
    交換

    EXCHANGE_DRAX
    KpiType

    KPI_TYPE_CPCL

    KPI_TYPE_CPCV

    KPI_TYPE_CPV

    KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST

    KPI_TYPE_MAXIMIZE_PACING

    KPI_TYPE_TOS10
    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

2024 年 2 月 28 日

新機能

カスタマー マッチ オーディエンスからメンバーを明示的に削除する機能が追加されました。

新しいエクスチェンジのターゲティングのサポートを追加しました。

v3

v2

2024 年 1 月 29 日

新機能

新しい floodlightGroups.floodlightActivities サービス。

新しいフィールドを追加して、YouTube とパートナーの広告申込情報 Google TV の広告枠をターゲティングに含めている。

ディスプレイ &ビデオ 360 の動画 360 user です。

v3

v2

2023 年 11 月 14 日

新機能

カスタマー マッチのアップロード時にエンドユーザーの同意を渡すためのサポートを追加しました すべてのライブ バージョンのオーディエンス メンバーを確認できます。

v3

v2

2023 年 10 月 31 日

新機能

v3 を公開ベータ版から一般提供に移行しました。

v3 の AdGroupFormat 列挙値の名前をより正確に変更 適切な形式を反映させましょう

構造化データファイル v7 のサポートを追加し、 v2 と v3 での SDF_VERSION_7 列挙値。

v3

  • 次の列挙値が削除されました。

    列挙型値
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • 次の列挙値が追加されました。

    列挙型値
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE
    SdfVersion

    SDF_VERSION_7

v2

  • 次の列挙値が追加されました。

    列挙型値
    SdfVersion

    SDF_VERSION_7

2023 年 10 月 2 日

新機能

公開ベータ版で v3 をリリースしました。これには次の変更が含まれています。

移行ガイドの手順に沿って、v2 から v3 です。

3 つの新しい LineItemType 値のサポートを追加しました。 YoutubeAndPartnersBiddingStrategyType、他 1 件の新着メール PartnerCostType（v2 と v3）。

v3

v2

2023 年 8 月 25 日

新機能

2 つのエクスチェンジと 2 つの新しい YouTube とパートナー 入札戦略タイプをご覧ください。

YouTube に新しい effectiveContentCategory フィールドを追加しました。 ここにはパートナーの広告申込情報で 次の場合に広告申込情報で使用される YoutubeAndPartnersContentCategory 広告主と広告申込情報の両方のレベルで割り当てられた値が考慮されます。

v2

2023 年 6 月 5 日

新機能

構造化データファイルに新しい SdfVersion 値を追加しました。 （SDF）v6 を v1 と v2 でサポートしています。

v2

  • 次の列挙値が追加されました。

    列挙型値
    SdfVersion

    SDF_VERSION_6

v1

  • 次の列挙値が追加されました。

    列挙型値
    SdfVersion

    SDF_VERSION_6

2023 年 3 月 9 日

新機能

新しい LineItemWarningMessage 値を追加しました。 広告申込情報の warningMessages フィールドに割り当てられる（既存のバケットがある場合） 非推奨の excludeFirstPartyAudience フィールドを true。excludeFirstPartyAudience フィールドは廃止されます 2023 年 3 月 25 日以降は false に設定されます。

v2

  • 次の列挙値が追加されました。

    列挙型値
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • 次の列挙値が追加されました。

    列挙型値
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

2023 年 2 月 8 日

新機能

YouTubeAdGroup とリソースを取得する機能を追加しました。 YouTubeAdGroupAd のリソース、YouTube 広告グループ リソース ターゲティングをご覧ください。さらに YouTube 広告グループで使用される取得可能なターゲティング タイプ できます。YouTube と動画の復元に関する新しいガイドページパートナー リソースをご覧ください。

v1 と v2 で 4 つのエクスチェンジのサポートを追加しました。

v2

v1

  • 次の列挙値が追加されました。

    列挙型値
    交換

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

2022 年 12 月 6 日

新機能

v2 を公開ベータ版から一般提供に移行しました。

新しい assignedTargetingOptionIdAlias フィールドを AssignedTargetingOption リソース: assignedTargetingOptionId: ターゲティングの取得時と削除時に使用します。 このフィールドは、 列挙して割り当てられますエイリアス値は、関連する列挙値として文字列です。

新しい billingConfig フィールドを Advertiser リソース。

YouTube とログのパートナーのオーバーザトップ広告申込情報 3 つの新しい LineItemType 値で識別できます。

v1 と v2 の多数の list メソッドについて、最大ページサイズを 200 に増やしました。「 変更はありません。

v2

v1

既知の問題

このアップデートでは、v2 の以下の既知の問題が修正されています。

  • 列挙型を使用して割り当てられたターゲティング タイプの割り当て済みターゲティング オプション 値を削除または取得できなかった） assignedTargetingOptionId が使用されており、 列挙値を使用できます。今回の更新により 割り当てられたターゲティングは オプションを削除または取得するには、 assignedTargetingOptionId または列挙値（以下で識別される） 新しい assignedTargetingOptionIdAlias フィールド AssignedTargetingOption リソース。
  • 広告申込情報の bulkUpdate リクエストで、 advertisersId リクエスト パラメータで、エラーを返します。今回のアップデートにより メソッドが修正され、リクエスト パラメータの名前が advertisersId が advertiserId に設定されます。

2022 年 10 月 27 日

親広告申込情報を複製する機能が追加されました。 InsertionOrder.

一部の広告掲載オーダー ターゲティングの書き込みサポートを導入しました 2 つのターゲット タイプを追加し、create と delete メソッドを advertisers.insertionOrders.targetingTypes.assignedTargetingOptions あります。

新機能

v2

v1

v1 には新機能が追加されていません。

2022 年 9 月 20 日

公開ベータ版で v2 をリリースしました。変更内容は次のとおりです。

移行ガイドの手順に沿って、v1 から v2 です。

v1 で 3 つの新しいエクスチェンジのサポートを追加しました。

新機能

v2

v1 と v2 の変更点は次のとおりです。

v1

  • v1 では、次の列挙値が追加されました。

    列挙型値
    交換

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

2022 年 5 月 26 日

InventorySource リソースとリソースを作成する機能を追加しました。 新しい Google Cloud コンソールから GuaranteedOrder リソースを管理する inventorySources サービスの書き込みメソッドと、 guaranteedOrders サービス。

modelReadiness フィールドが CustomBiddingAlgorithm リソース。このフィールドは、インシデントの アルゴリズムのモデルが自動的に適用されます。

新しい filter クエリ パラメータ機能が有効になりました: ユーザーが使用できる advertisers.creatives.list メソッド updateTime で作成されたクリエイティブのみを取得する タイムスタンプの前か後かを確認します

最新の SDF バージョン v5.5 のサポートを SdfVersion 列挙値の追加。

新機能

2022 年 3 月 31 日

ターゲティングの取得と設定のサポートを コンテンツの長さ、ストリームの種類、 genre。

billableOutcome フィールドを InsertionOrder に追加しました 渡されます。

raiseBidForDeals フィールドを その値に入札するかどうかをユーザーがMaximizeSpendBidStrategy ターゲットとする取引に広告主の最小価格を適用する。

新機能

2022 年 2 月 2 日

作成、更新、 特定のカスタマー マッチのメンバーを編集する FirstAndThirdPartyAudience のリソース。「 カスタマー マッチ オーディエンスをアップロード] ページで、 これらの新機能の使い方について詳しくは、オーディエンスを使用するをご覧ください。

新しい reservationType フィールドが導入されました InsertionOrder、LineItem リソースがタグ形式予約型配信かプログラマティック取引かを識別するリソース 保証されていますが、保証されません。

広告申込情報で自動的にターゲティングを行うかどうかを取得して設定する機能を追加しました。 新しいexcludeNewExchangesを介した新しいエクスチェンジの開拓 表示されます。

新機能に加えて、デフォルトの割り当て上限が 2 倍になりました。

新機能

2021 年 12 月 8 日

ターゲティング タイプでオーディオ コンテンツ タイプのターゲティングがサポートされるようになりました。 TARGETING_TYPE_AUDIO_CONTENT_TYPE.

新機能

2021 年 11 月 8 日

カスタム入札アルゴリズムとそのスクリプトを管理するための完全サポートが追加されました。 以下に例を示します。

新たに [カスタム入札の実装] ページが 広告申込情報の管理に関するガイドで カスタム入札アルゴリズムの作成、スクリプトのアップロード カスタム入札アルゴリズムを広告申込情報の入札戦略として割り当てる。

最新の SDF バージョン v5.4 のサポートを SdfVersion 列挙値の追加。

新機能

2021 年 9 月 14 日

ターゲティング タイプに近隣地域ターゲティングのサポートを追加 TARGETING_TYPE_BUSINESS_CHAIN、 TARGETING_TYPE_POI.

利用可能なリソースを検索する機能を追加 TARGETING_TYPE_BUSINESS_CHAIN、 TARGETING_TYPE_POI 個のターゲティング オプション: targetingTypes.targetingOptions.search は使用できないため、 targetingTypes.targetingOptions.get または targetingTypes.targetingOptions.list メソッドを使用します。

新しく導入された sharedAdvertiserIds と customBiddingAlgorithmState フィールドをカスタム入札に追加 アルゴリズムのリソースであり、 GOAL_BUILDER_BASED カスタム入札アルゴリズム タイプ。

Exchange 列挙型に 2 つの新しい値を追加しました。

新機能

2021 年 8 月 4 日

Open Measurement の有効化がサポートされるようになりました [広告枠ターゲティング]を選択します TARGETING_TYPE_OMID。

返されるターゲティング オプションの割り当ての最大数を増やしました さまざまな広告主、キャンペーン、 広告掲載オーダー、広告申込情報に割り当てられたターゲティング pageSize メソッド パラメータを使ったオプション リスト メソッドの使用。

新機能

2021 年 5 月 26 日

advertisers.invoices サービスをリリースしました。これにより、 ユーザー:

  • 特定の月に広告主に発行された請求書を取得する。
  • ある月に広告主が使用した通貨コードを調べる。

キャンペーンに「campaignBudgets」フィールドを追加しました リソースです。広告掲載オーダーの予算セグメントは以下にリンクできます。 キャンペーンの予算 キャンペーンの合計予算額に加算されます

以下に対するサポートを追加しました。 ネイティブ コンテンツ内の位置ターゲティング ターゲティング タイプ「TARGETING_TYPE_NATIVE_CONTENT_POSITION」。

新しい prismaEnabled フィールドを広告主に追加しました。 Mediaocean の Prisma ツールとの統合をユーザーが有効にできます。

以下に対する ENTITY_STATUS_PAUSED 列挙値のサポートを有効にしました。 広告主の entityStatus フィールド。

新機能

2021 年 4 月 29 日

新しいフィールドを Channel と 行の数を返す除外キーワード リスト リソース そのリソースをターゲティングに利用します。新しい filter を有効にしました 広告申込情報のリストメソッドのプロパティ。これにより、ユーザーは 特定のチャネルまたは除外キーワードを使用している広告申込情報のみを取得 ターゲティングに含めることができます

新機能

2021 年 3 月 30 日

広告申込情報サービスに新しいメソッドを追加しました。このメソッドは、 デフォルトの設定が使用されますこれらのデフォルト値は 特定の広告申込情報タイプ、設定、割り当て済みの 親広告掲載オーダーのターゲティングです

キャンペーン ターゲティングを 新しいキャンペーン ターゲティング サービス 追加の一括リスト方法。

アプリのターゲティングを拡張し、アプリのターゲティングも可能に より多くのプラットフォームで。

advertisers.channels.sites に複数の変更が加えられました。 partners.channels.sites、 advertisers.negativeKeywordLists.negativeKeywords 個のサービスを チャンネルと除外キーワード リストの内容を簡単に管理できる。これらの 主な変更点は次のとおりです。

  • replace メソッドの追加。ユーザーは、このメソッドにより、 チャンネルや除外キーワード リストの既存のコンテンツ。
  • 既存のビジネスがリソースに存在しないという createdSites に含まれているアイテム、または 一括編集の createdNegativeKeywords 項目 できます。
  • 1 つのアイテムで返すことができるアイテムの最大数の増加 サイトのリストのページを見るか、 除外キーワードの一覧表示のレスポンス。

新機能

サポートの終了

2021 年 2 月 24 日

新しい広告掲載オーダー ターゲティング サービスを導入し、 追加の一括リスト方法を使用すると、 広告掲載オーダーに割り当てられているターゲティングです。クリエイティブ リソースを展開し、 出力専用のクリエイティブ フィールドを 第三者オーディオクリエイティブに対して 使用できます新しいパフォーマンス目標タイプを追加しました 広告掲載オーダーとキャンペーンで使用 説明します。

新機能

2021 年 1 月 27 日

テレビ広告掲載オーダーとオーバー ザ トップ ラインを取得、管理 アイテムの管理に 新しい InsertionOrderType フィールドと 新しい LineItemType 列挙値です。モバイルアプリのサポートを追加 mobileApp 広告申込情報フィールドでこれらの広告申込情報を指定できます。 拡張されたエクスチェンジ、Google オーディエンス、 追加の列挙値による SDF サポート。紹介: advertisers.list のフィルタリングと並べ替えが可能 値を取得します。

新機能

2020 年 12 月 4 日

以下を検索する機能を追加しました [地域] ターゲティング オプションと複数のリソースをフィルタ メソッドの結果を最終更新時刻で一覧表示します。導入された new LineItemWarningMessage: 警告が警告されたことをユーザーに通知します。 広告申込情報でサポート終了の地域ターゲティングを使用しています。

新機能

2020 年 11 月 5 日

作成、割り当て、有効化の機能を追加 手動トリガーを使用して 関連付けられた広告申込情報を 支出を表します。ターゲット拡張オプションを導入し、 設定すると、類似ユーザーを含むように広告申込情報のターゲティングを拡張できます オーディエンスにリーチしますカスタム セグメント ID フィールドを以下に追加しました DoubleVerify と Integral Ad Science 使用されるオブジェクト 第三者のベリフィケーションのターゲティング。

新機能

2020 年 10 月 12 日

取得可能な警告メッセージを広告申込情報に追加しました パフォーマンス目標タイプがあります追加済み 広告申込情報を一覧表示するときにフィルタ可能なフィールドとして warningMessages。

新機能に加えて、新しい割り当て上限が適用され、 バッチ リクエストの利用に関する新しいドキュメントが追加されました。

新機能

2020 年 8 月 28 日

広告主監査メソッドのレスポンスに新しいフィールドを追加しました。 新しいフィルタ可能なフィールドをさまざまな list メソッドに追加。

新機能

2020 年 8 月 4 日

新しいユーザー管理、パートナー、パートナー ターゲティング サービスをリリースしました。アカウント エンティティ数の上限に達することを事前に防ぐためのツールを導入しました。オーディオ広告申込情報がサポートされるようになりました。また、広告申込情報と広告掲載オーダーの入札戦略でカスタム入札アルゴリズムを使用できるようになりました。

新機能

2020 年 6 月 24 日

パートナー チャネルと広告主チャネル用の create メソッド、新しい FirstAndThirdPartyAudience フィールド、追加の exchange 列挙値を追加する小規模なアップデートをリリースしました。

新機能

2020 年 6 月 2 日

ターゲット設定可能なエンティティのサブセットの作成、パッチ適用、入力を行える機能が導入され、3 つのターゲティング タイプ（チャネル、デジタル コンテンツ ラベルの除外、デリケートなカテゴリの除外）で広告主レベルのターゲティングを変更する機能が追加されました。

新機能

2020 年 4 月 27 日

大規模な機能セットをリリースし、API の範囲を SDF 以外にも拡大しました。追加済み 主要なリソース管理です。広告主、キャンペーン、広告掲載オーダー、広告申込情報、 作成できます。新機能では、広告申込情報レベルでターゲティングを編集することもできます。

新機能

次のサービスが追加されました。

サービスメソッド
<ph type="x-smartling-placeholder"></ph> 広告主

<ph type="x-smartling-placeholder"></ph> 作成

<ph type="x-smartling-placeholder"></ph> 削除

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト

<ph type="x-smartling-placeholder"></ph> パッチ
<ph type="x-smartling-placeholder"></ph> advertisers.assets

<ph type="x-smartling-placeholder"></ph> アップロード
<ph type="x-smartling-placeholder"></ph> advertisers.campaigns

<ph type="x-smartling-placeholder"></ph> 作成

<ph type="x-smartling-placeholder"></ph> 削除

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト

<ph type="x-smartling-placeholder"></ph> パッチ
<ph type="x-smartling-placeholder"></ph> advertisers.channels

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> advertisers.creatives

<ph type="x-smartling-placeholder"></ph> 作成

<ph type="x-smartling-placeholder"></ph> 削除

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト

<ph type="x-smartling-placeholder"></ph> パッチ
<ph type="x-smartling-placeholder"></ph> advertisers.insertionOrders

<ph type="x-smartling-placeholder"></ph> 作成

<ph type="x-smartling-placeholder"></ph> 削除

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト

<ph type="x-smartling-placeholder"></ph> パッチ
<ph type="x-smartling-placeholder"></ph> advertisers.lineItems

<ph type="x-smartling-placeholder"></ph> bulkEditLineItemAssignedTargetingOptions

<ph type="x-smartling-placeholder"></ph> bulkListLineItemAssignedTargetingOptions

<ph type="x-smartling-placeholder"></ph> 作成

<ph type="x-smartling-placeholder"></ph> 削除

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト

<ph type="x-smartling-placeholder"></ph> パッチ
<ph type="x-smartling-placeholder"></ph> advertisers.lineItems.targetingTypes.assignedTargetingOptions

<ph type="x-smartling-placeholder"></ph> 作成

<ph type="x-smartling-placeholder"></ph> 削除

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> advertisers.locationLists

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> advertisers.negativeKeywordLists

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> combinedAudiences

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> customLists

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> firstAndThirdPartyAudiences

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> floodlightGroups

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> パッチ
<ph type="x-smartling-placeholder"></ph> googleAudiences

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> inventorySourceGroups

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> inventorySources

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> partners.channels

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト
<ph type="x-smartling-placeholder"></ph> partners.channels

<ph type="x-smartling-placeholder"></ph> 入手

<ph type="x-smartling-placeholder"></ph> リスト

2020 年 3 月 9 日

ディスプレイ &ビデオ 360 とVideo 360 API v1。これは API の初期バージョンです。

既知の問題

なし。