このページは、ディスプレイ＆ビデオ 360 API のリリースノートを提供するものです。
最新の API バージョン: v3
2024 年 10 月 22 日
新機能
広告視聴単価のパフォーマンス目標のサポートを追加しました。
接続済みデバイスのターゲティングを設定および取得する機能を追加しました。
[サードパーティの検証ツールによるターゲティング] に、Adloox の新しいブランド保護設定を追加しました。
v8 構造化データ ファイルのダウンロードのサポートを追加しました。現在はクローズド ベータ版です。
v3
次のフィールドが追加されました。
オブジェクト フィールド AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContent次の列挙値が追加されました。
列挙型 値 DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
サポートが終了した値
SDF v5.5 のサポートを終了しました。SDF v5.5 は2024 年 10 月 3 日に廃止されます。
v3
次の列挙値は非推奨になりました。
列挙型 値 SdfVersionSDF_VERSION_5_5
2024 年 8 月 15 日
新機能
Netflix の Exchange タイプのサポートを追加しました。
v3
次の列挙値が追加されました。
列挙型 値 交換 EXCHANGE_NETFLIX
v2
次の列挙値が追加されました。
列挙型 値 交換 EXCHANGE_NETFLIX
2024 年 7 月 15 日
新機能
v3 で、広告申込情報と広告グループの構造化データ ファイルを QA 形式でダウンロードするサポートを追加しました。
v3
次のフィールドが追加されました。
リソース フィールド IdFilter 次の列挙値が追加されました。
列挙型 値 FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
2024 年 6 月 17 日
新機能
広告主単位で割り当てられたキーワード ターゲティングの管理機能を追加しました。
広告掲載オーダー リソースに新しい optimizationObjective フィールドを追加しました。optimizationObjective は、許可リストに登録されたお客様のみご利用いただけます。
v3
次のフィールドが追加されました。
リソース フィールド InsertionOrder 次のメソッドで、次のターゲティング タイプがサポートされるようになりました。
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 次の列挙値が追加されました。
列挙型 値 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
次の列挙値が追加されました。
列挙型 値 AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
交換 EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
2024 年 2 月 28 日
新機能
カスタマー マッチ オーディエンスからメンバーを明示的に削除する機能を追加しました。
新しいエクスチェンジのターゲティングのサポートを追加しました。
v3
次のフィールドが追加されました。
リソース フィールド firstAndThirdPartyAudiences.editCustomerMatchMembers 次の列挙値が追加されました。
列挙型 値 交換 EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
次のフィールドが追加されました。
リソース フィールド firstAndThirdPartyAudiences.editCustomerMatchMembers 次の列挙値が追加されました。
列挙型 値 交換 EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
2024 年 1 月 29 日
新機能
新しい floodlightGroups.floodlightActivities サービスを使用して Floodlight アクティビティを取得する機能を追加しました。
YouTube とパートナーの広告申込情報のターゲティングに Google TV 広告枠が含まれているかどうかを示す新しいフィールドを追加しました。
ディスプレイ＆ビデオ 360 のユーザーの最終ログイン時間を通知する新しいフィールドを追加しました。
v3
次のメソッドが追加されました。
サービス メソッド floodlightGroups.floodlightActivities 次のフィールドが追加されました。
リソース フィールド ユーザー YoutubeAndPartnersInventorySourceConfig
v2
次のメソッドが追加されました。
サービス メソッド floodlightGroups.floodlightActivities 次のフィールドが追加されました。
リソース フィールド ユーザー YoutubeAndPartnersInventorySourceConfig
2023 年 11 月 14 日
新機能
すべての公開バージョンで、カスタマー マッチ オーディエンス メンバーをアップロードする際のエンドユーザーの同意の渡しのサポートを追加しました。
v3
次のフィールドが追加されました。
リソース フィールド ContactInfoList MobileDeviceIdList
v2
次のフィールドが追加されました。
リソース フィールド ContactInfoList MobileDeviceIdList
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 をリリースしました。このバージョンには次の変更が含まれています。
- 近接性ロケーション リストを完全に管理できる機能。
advertisers.locationLists.assignedLocationsサービスを使用して、TARGETING_LOCATION_TYPE_PROXIMITYLocationListリソースに割り当てられたロケーションを作成、削除できます。 - 新しいブール値
enableOptimizedTargetingフィールド。TargetingExpansionConfigオブジェクトのtargetingExpansionLevelフィールドに代わるものです。 AdvertiserリソースのbillingConfigフィールドの要件。advertisers.createリクエストを行うときに含める必要があります。また、Partnerリソースに新しいbillingConfigフィールドが必要です。- v2 の
YoutubeAdGroupリソースとYoutubeAdGroupAdリソースに代わる新しいAdGroupリソースとAdGroupAdリソース。
移行ガイドの手順に沿って、v2 から v3 に移行します。
v2 と v3 で、3 つの新しい LineItemType 値、1 つの新しい YoutubeAndPartnersBiddingStrategyType、1 つの新しい PartnerCostType のサポートが追加されました。
v3
次のメソッドが追加されました。
サービス メソッド advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules 次のメソッドが削除されました。
サービス メソッド advertisers.manualTriggers activate
create
無効にして
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
次のメソッドの動作が変更されました。
メソッド 変更 advertisers.locationLists.create TARGETING_LOCATION_TYPE_PROXIMITYLocationListリソースの作成がサポートされるようになりました。advertisers.locationLists.patch TARGETING_LOCATION_TYPE_PROXIMITYLocationListリソースの更新をサポートするようになりました。advertisers.locationLists.assignedLocations.bulkEdit TARGETING_LOCATION_TYPE_PROXIMITYLocationListリソースのAssignedLocationリソースの一括編集がサポートされるようになりました。advertisers.locationLists.assignedLocations.create TARGETING_LOCATION_TYPE_PROXIMITYLocationListリソースでのAssignedLocationリソースの作成をサポート。次のクエリ パラメータが追加されました。
メソッド パラメータ inventorySources.get 次のフィールドが必須になりました。
リソース フィールド 広告主 次のフィールドが追加されました。
リソース フィールド BiddingStrategy InsertionOrder パートナー TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig 次のフィールドが削除されました。
リソース フィールド InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
次の列挙値が追加されました。
列挙型 値 CustomBiddingAlgorithmType RULE_BASED
LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
次の列挙値は削除されました。
列挙型 値 LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
次の列挙値が追加されました。
列挙型 値 LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
2023 年 8 月 25 日
新機能
2 つのエクスチェンジと 2 つの新しいYouTube とパートナーの入札戦略タイプのサポートを追加しました。
YouTube とパートナーの広告申込情報に新しい effectiveContentCategory フィールドを追加し、広告主と広告申込情報の両方のレベルで割り当てられた値を考慮する際に、広告申込情報で使用される YoutubeAndPartnersContentCategory を表示できるようにしました。
v2
次のフィールドが追加されました。
リソース フィールド YoutubeAndPartnersSettings 次のフィールドが削除されました。
リソース フィールド InventorySource subSitePropertyId
次の列挙値が追加されました。
列挙型 値 交換 EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
2023 年 6 月 5 日
新機能
v1 と v2 の 構造化データファイル（SDF）v6 に新しい SdfVersion 値を追加しました。
v2
次の列挙値が追加されました。
列挙型 値 SdfVersion SDF_VERSION_6
v1
次の列挙値が追加されました。
列挙型 値 SdfVersion SDF_VERSION_6
2023 年 3 月 9 日
新機能
新しい LineItemWarningMessage 値を追加しました。この値は、非推奨の excludeFirstPartyAudience フィールドが true に設定されている広告申込情報の warningMessages フィールドに割り当てられます。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
次のメソッドが追加されました。
サービス メソッド advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions 次のフィールドが追加されました。
サービス メソッド AssignedTargetingOption YoutubeAndPartnersSettings 次の列挙値が追加されました。
列挙型 値 交換 EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
次の列挙値が追加されました。
列挙型 値 交換 EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
2022 年 12 月 6 日
新機能
v2 を公開ベータ版から一般提供に移行しました。
AssignedTargetingOption リソースに新しい assignedTargetingOptionIdAlias フィールドを追加しました。ターゲティングの取得と削除時に assignedTargetingOptionId の代わりに使用できます。このフィールドは、列挙型で割り当てられたターゲティング タイプの割り当てられたターゲティング オプションにのみ設定されます。エイリアス値は、関連する列挙型値を文字列として指定します。
Advertiser リソースに新しい billingConfig フィールドを追加しました。
YouTube とパートナーのオーバー ザ トップ広告申込情報の取得をサポートしました。この広告申込情報は、3 つの新しい LineItemType 値で識別されます。
v1 と v2 の多くの list メソッドの最大ページサイズを 200 に増やしました。デフォルトのページサイズは変更されません。
v2
次のフィールドが追加されました。
リソース フィールド 広告主 AssignedTargetingOption 次の列挙値が追加されました。
列挙型 値 LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
次のリストメソッドの最大ページサイズを増やしました。
v1
次のリストメソッドの最大ページサイズを増やしました。
既知の問題
このアップデートでは、v2 の次の既知の問題が修正されています。
- v2 で列挙値を使用して割り当てられたターゲティング タイプの割り当てられたターゲティング オプションは、
assignedTargetingOptionIdを使用して削除または取得できませんでした。代わりに、ユーザーが列挙値を使用することが想定されていました。この更新により、割り当てられたターゲティング オプションは、assignedTargetingOptionIdまたはAssignedTargetingOptionリソースの新しいassignedTargetingOptionIdAliasフィールドで識別される列挙値を使用して削除または取得できるようになりました。 - 広告申込情報の
bulkUpdateリクエストでadvertisersIdリクエスト パラメータが正しく使用されておらず、エラーが返されました。今回の更新により、このメソッドは修正され、リクエスト パラメータの名前がadvertisersIdからadvertiserIdに変更されました。
2022 年 10 月 27 日
親 InsertionOrder 内で既存の広告申込情報を複製する機能を追加しました。
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions サービスに create メソッドと delete メソッドを追加し、部分的な広告掲載オーダーのターゲティングの書き込みをターゲティング タイプのサブセットでサポートしました。
新機能
v2
次のメソッドが追加されました。
サービス メソッド advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
v1 には新機能は追加されていません。
2022 年 9 月 20 日
公開ベータ版として v2 をリリースしました。このバージョンには次の変更が含まれています。
advertisers.lineItemsサービスとadvertisers.lineItems.targetingTypes.assignedTargetingOptionsサービスのgetメソッドとlistメソッドを使用して、YouTube とパートナーの広告申込情報とそのターゲティング設定を取得する機能。advertisers.lineItemsサービスに 2 つの新しい一括ターゲティング メソッドが追加されました。これにより、1 つのリクエストで複数の広告申込情報に割り当てられたターゲティングの編集と取得 が可能になります。- 1 つのリクエストで複数の広告申込情報の
entityStatusを更新できる新しいbulkUpdateメソッド。 targetingTypes.targetingOptionsサービスを使用して取得されたターゲティング オプション ID ではなく、ターゲティング タイプのサブセットのAssignedTargetingOptionリソースを割り当て、列挙型値を使用して取得する必要がある新しいターゲティング ロジック。
移行ガイドの手順に沿って、v1 から v2 に移行します。
v1 で 3 つの新しいエクスチェンジのサポートを追加しました。
新機能
v2
v1 と v2 の変更点は次のとおりです。
v2 では、次のメソッドが追加されました。
サービス メソッド advertisers.lineItems bulkEditAssignedTargetingOptions
v2 では、次のメソッドが削除されました。
サービス メソッド advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
v2 では、次のメソッドの名前が変更されました。
サービス 古いメソッド名 新しいメソッド名 advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions パートナー bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions 次のターゲティング タイプの
AssignedTargetingOptionリソースは、v2 でターゲティングの割り当てに列挙型を使用します。これらのターゲティング タイプのAssignedTargetingOptionリソースのassignedTargetingOptionIdフィールドも、v2 で更新され、列挙値の文字列バージョンが使用されるようになりました。ターゲット タイプ 列挙型 TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT 環境 TARGETING_TYPE_EXCHANGE 交換 TARGETING_TYPE_GENDER 性別 TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY 視認性 v2 で追加されたフィールドは次のとおりです。
v2 では、次のフィールドが削除されました。
v2 では、次のフィールドが必須になりました。
v2 では、次の列挙値が追加されました。
列挙型 値 AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
交換 EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
v2 では、次の列挙値が削除されました。
列挙型 値 LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
v1 では、次の列挙値が追加されました。
列挙型 値 交換 EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
2022 年 5 月 26 日
新しい inventorySources サービス書き込みメソッドと新しい guaranteedOrders サービスを使用して、InventorySource リソースを作成し、GuaranteedOrder リソースを管理する機能を追加しました。
CustomBiddingAlgorithm リソースに modelReadiness フィールドを導入しました。このフィールドには、アクセスできる広告主ごとに、アルゴリズムのモデルの準備状況が表示されます。
advertisers.creatives.list メソッドに新しい filter クエリ パラメータ機能を有効にしました。これにより、ユーザーは指定したタイムスタンプの前または後に updateTime が含まれるクリエイティブのみを取得できるようになりました。
SdfVersion 列挙型の値を追加して、最新の SDF バージョン v5.5 のサポートを追加しました。
新機能
次のメソッドが追加されました。
サービス メソッド guaranteedOrders inventorySources 次のフィールドが追加されました。
リソース フィールド CustomBiddingAlgorithm InventorySource 次の列挙値が追加されました。
列挙型 値 SdfVersion 次のリストメソッドは、次のプロパティでフィルタできるようになりました。
メソッド フィールド advertisers.creatives.list
2022 年 3 月 31 日
コンテンツの長さ、配信タイプ、ジャンルのターゲティングの取得と設定のサポートを追加しました。
billableOutcome フィールドを InsertionOrder オブジェクトに追加しました。
MaximizeSpendBidStrategy オブジェクトに raiseBidForDeals フィールドを導入し、入札戦略でターゲットに設定されている取引に広告主の最小価格を適用するかどうかをユーザーが設定できるようにしました。
新機能
次のフィールドが追加されました。
リソース フィールド AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption 次の列挙値が追加されました。
列挙型 値 TargetingType
2022 年 2 月 2 日
特定のカスタマー マッチ FirstAndThirdPartyAudience リソースの作成、更新、メンバーの編集のサポートを追加しました。これらの新機能の使用方法について詳しくは、新しいオーディエンスの使用ガイドのカスタマー マッチ オーディエンスのアップロードのページをご覧ください。
InsertionOrder リソースと LineItem リソースに新しい reservationType フィールドを導入しました。このフィールドは、リソースがタグ保証、プログラマティック保証、または保証なしのいずれであるかを識別します。
新しい excludeNewExchanges フィールドを使用して、広告申込情報で新しいエクスチェンジを自動的にターゲットに含めるかどうかを取得および設定する機能が追加されました。
新機能に加えて、デフォルトの割り当て上限が 2 倍になりました。
新機能
次のメソッドが追加されました。
サービス メソッド firstAndThirdPartyAudiences 次のフィールドが追加されました。
リソース フィールド FirstAndThirdPartyAudience InsertionOrder LineItem
2021 年 12 月 8 日
ターゲティング タイプ TARGETING_TYPE_AUDIO_CONTENT_TYPE に、オーディオ コンテンツ タイプのターゲティングのサポートを追加しました。
新機能
次のフィールドが追加されました。
リソース フィールド AssignedTargetingOption TargetingOption 次の列挙値が追加されました。
列挙型 値 TargetingType
2021 年 11 月 8 日
カスタム入札アルゴリズムとそのスクリプトの管理を完全にサポートしました。以下が該当します。
- 新しい
customBiddingAlgorithmsをcreateし、既存のcustomBiddingAlgorithmsを更新する関数。 - 利用可能なリソースのロケーションを取得し、そのロケーションにファイルをアップロードするプロセスでスクリプトをアップロードする機能。
customBiddingScriptsを取得してcreateする新しいcustomBiddingAlgorithms.scriptsサービス。
広告申込情報の管理ガイドに、カスタム入札を実装するという新しいページを追加しました。このページでは、カスタム入札アルゴリズムの作成、スクリプトのアップロード、カスタム入札アルゴリズムを広告申込情報の入札戦略として割り当てるプロセスについて説明しています。
SdfVersion 列挙型の値を追加し、最新の SDF バージョン v5.4 のサポートを追加しました。
新機能
次のメソッドが追加されました。
サービス メソッド customBiddingAlgorithms customBiddingAlgorithms.scripts media 次の列挙値が追加されました。
列挙型 値 SdfVersion
2021 年 9 月 14 日
ターゲティング タイプ TARGETING_TYPE_BUSINESS_CHAIN と TARGETING_TYPE_POI で、近隣地域ターゲティングのサポートを追加しました。
targetingTypes.targetingOptions.get メソッドまたは targetingTypes.targetingOptions.list メソッドでは取得できないため、targetingTypes.targetingOptions.search を使用して利用可能な TARGETING_TYPE_BUSINESS_CHAIN ターゲティング オプションと TARGETING_TYPE_POI ターゲティング オプションを検索する機能を追加しました。
カスタム入札アルゴリズム リソースに新しい sharedAdvertiserIds フィールドと customBiddingAlgorithmState フィールドを導入し、GOAL_BUILDER_BASED カスタム入札アルゴリズム タイプのサポートを追加しました。
Exchange 列挙型に 2 つの新しい値を追加しました。
新機能
次のフィールドが追加されました。
リソース フィールド AssignedTargetingOption CustomBiddingAlgorithm TargetingOption TargetingOptions.search リクエスト本文 次の列挙値が追加されました。
列挙型 値 CustomBiddingAlgorithmType 交換 TargetingType 次のリストメソッドは、次のプロパティでフィルタできるようになりました。
メソッド フィールド customBiddingAlgorithms.list
2021 年 8 月 4 日
ターゲティング タイプ TARGETING_TYPE_OMID で、Open Measurement 対応広告枠のターゲティングのサポートを追加しました。
pageSize メソッド パラメータを使用して、さまざまな広告主、キャンペーン、広告掲載オーダー、広告申込情報に割り当てられたターゲティング オプション リスト メソッドの 1 ページで返される割り当てられたターゲティング オプションの最大数を増やしました。
新機能
次のフィールドが追加されました。
リソース フィールド AssignedTargetingOption TargetingOption 次の列挙値が追加されました。
列挙型 値 TargetingType 次のリストメソッドの最大ページサイズを増やしました。
2021 年 5 月 26 日
advertisers.invoices サービスをリリースしました。これにより、ユーザーは次のことができます。
- 特定の月に広告主に発行された請求書を取得します。
- 特定の月における広告主様が使用した通貨コードを検索する。
キャンペーン リソースに campaignBudgets フィールドを追加しました。広告掲載オーダーの予算セグメントはキャンペーンの予算にリンクできます。これにより、関連するセグメントの予算の合計額がキャンペーンの合計予算額に制限されます。
新しいターゲティング タイプ TARGETING_TYPE_NATIVE_CONTENT_POSITION で、ネイティブ コンテンツの位置ターゲティングのサポートを追加しました。
広告主リソースに新しい prismaEnabled フィールドを導入し、ユーザーが Mediaocean の Prisma ツールとの統合を有効にできるようにしました。
広告主の entityStatus フィールドで ENTITY_STATUS_PAUSED 列挙型値のサポートを有効にしました。
新機能
次のメソッドが追加されました。
サービス メソッド advertisers.invoices 次のフィールドが追加されました。
リソース フィールド 広告主 AssignedTargetingOption TargetingOption 次の列挙値が追加されました。
列挙型 値 AssignedTargetingOption.Recency 交換 TargetingType 次のフィールドで、次の列挙型の値が有効になりました。
リソース フィールド 値 広告主 entityStatus ENTITY_STATUS_PAUSED
2021 年 4 月 29 日
チャンネル リソースと除外キーワード リスト リソースに、ターゲティングにリソースを使用した行アイテムの数を返す新しいフィールドを追加しました。広告申込情報リスト メソッドに新しい filter プロパティを有効にしました。これにより、ユーザーはターゲティングで特定のチャネルまたは除外キーワード リストを使用している広告申込情報のみを取得できるようになります。
新機能
次のフィールドが追加されました。
リソース フィールド チャネル 次のリストメソッドは、次のプロパティでフィルタできるようになりました。
メソッド フィールド advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
2021 年 3 月 30 日
デフォルト構成で広告申込情報を生成する広告申込情報サービスに新しいメソッドを追加しました。これらのデフォルト値は、指定された広告申込情報のタイプ、親広告掲載オーダーの設定と割り当てられたターゲティングに基づいています。
新しいキャンペーン ターゲティング サービスと追加の一括リスト方法によるキャンペーン ターゲティングの取得を有効にしました。
アプリ ターゲティングを拡張し、より多くのプラットフォームでアプリをターゲットにできるようになりました。
チャンネル リストと除外キーワード リストのコンテンツを簡単に管理できるように、advertisers.channels.sites、partners.channels.sites、advertisers.negativeKeywordLists.negativeKeywords サービスに複数の変更を加えました。変更内容は次のとおりです。
replaceメソッドの追加。これにより、ユーザーはチャンネルまたは除外キーワード リストの既存のコンテンツを完全に上書きできるようになります。- 一括編集リクエストの
createdSitesフィールドまたはcreatedNegativeKeywordsフィールドに既存のアイテムを含めないという要件を削除。 - サイトをリストまたは除外キーワードをリストのレスポンスの 1 ページで返されるアイテムの最大数の増加。
新機能
次のメソッドが追加されました。
次のフィールドが追加されました。
リソース フィールド AssignedTargetingOption.AppAssignedTargetingOptionDetails 次のリストメソッドの最大ページサイズを増やしました。
メソッド 以前の最大ページサイズ 新しい最大ページサイズ advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
サポートの終了
次の列挙値は、新規または既存のリソースに割り当てることができなくなりました。
列挙型 値 PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
2021 年 2 月 24 日
新しい広告掲載オーダー ターゲティング サービスと一括リストの追加方法を導入し、広告掲載オーダーに割り当てられたターゲティングの取得を可能にしました。クリエイティブ リソースを拡張し、サードパーティの音声クリエイティブで使用できる出力専用クリエイティブ フィールドを追加しました。広告掲載オーダーとキャンペーン リソースで使用できる新しいパフォーマンス目標タイプを追加しました。
新機能
次のメソッドが追加されました。
サービス メソッド advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 次のフィールドが追加されました。
リソース フィールド クリエイティブ 次の列挙値が追加されました。
列挙型 値 ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
2021 年 1 月 27 日
新しい InsertionOrderType フィールドと新しい LineItemType 列挙型値を導入し、テレビ広告掲載オーダーとオーバー ザ トップ広告申込情報の取得と管理を可能にしました。mobileApp 広告申込情報フィールドによるモバイルアプリ広告申込情報のサポートを追加しました。エクスチェンジ、Google オーディエンス、SDF のサポートを拡張し、列挙型の値を追加しました。最終更新日時で advertisers.list 値をフィルタして並べ替える機能を導入しました。
新機能
次のフィールドが追加されました。
リソース フィールド InsertionOrder LineItem 次の列挙値が追加されました。
列挙型 値 交換 GoogleAudienceType LineItemType SdfVersion 次のリスト メソッドを、次のフィールドで並べ替え、フィルタできるようになりました。
メソッド フィールド 広告主
2020 年 12 月 4 日
地域ターゲティング オプションを検索し、複数のリソースリスト メソッドの結果を最終更新日時でフィルタする機能を追加しました。新しい LineItemWarningMessage を導入し、広告申込情報で非推奨の地域ターゲティングが使用されている場合にユーザーに通知できるようにしました。
新機能
次のメソッドが追加されました。
サービス メソッド targetingTypes.targetingOptions 次の列挙値が追加されました。
列挙型 値 交換 LineItemWarningMessage 次のリスト メソッドを、次のフィールドで並べ替え、フィルタできるようになりました。
メソッド フィールド advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
2020 年 11 月 5 日
関連する広告申込情報の配信を開始する手動トリガーを作成、割り当て、有効にする機能が追加されました。ターゲットの拡張オプションを導入しました。このオプションを設定すると、広告申込情報のターゲティングを拡張し、ターゲット オーディエンスに類似するユーザーを含めることができます。サードパーティ検証ターゲティングで使用される DoubleVerify オブジェクトと Integral Ad Science オブジェクトに、カスタム セグメント ID フィールドを追加しました。
新機能
次のサービスが追加されました。
サービス メソッド advertisers.manualTriggers 次のフィールドが追加されました。
リソース フィールド AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight 次の列挙値が追加されました。
列挙型 値 LineItemFlightDateType 次のリストメソッドを、次のフィールドでフィルタできるようになりました。
メソッド フィールド advertisers.lineItems.list
2020 年 10 月 12 日
広告申込情報リソースとクリック率（CTR）のパフォーマンス目標タイプに、取得可能な警告メッセージを導入しました。広告申込情報を一覧表示する際のフィルタ可能なフィールドとして warningMessages を追加しました。
新機能に加えて、新しい割り当て上限が適用され、バッチ リクエストの使用に関する新しいドキュメントが利用可能になりました。
新機能
次のフィールドが追加されました。
リソース フィールド LineItem 次の列挙値が追加されました。
列挙型 値 PerformanceGoalType 次のリストメソッドを、次のフィールドでフィルタできるようになりました。
メソッド フィールド advertisers.lineItems.list
2020 年 8 月 28 日
広告主監査メソッドのレスポンスに新しいフィールドを追加し、さまざまなリストメソッドに新しいフィルタリング可能なフィールドを追加しました。
新機能
次のフィールドが追加されました。
リソース フィールド Advertisers.Audit レスポンスの本文 次のリストメソッドを、次のフィールドでフィルタできるようになりました。
メソッド フィールド advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
2020 年 8 月 4 日
新しいユーザー管理、パートナー、パートナー ターゲティング サービスをリリースしました。アカウント エンティティの上限に達しないようにユーザーが事前に対策を講じられるツールを導入しました。オーディオ広告申込情報のサポートと、広告申込情報と広告掲載オーダーの入札戦略でのカスタム入札アルゴリズムの使用を追加しました。
新機能
次のサービスが追加されました。
サービス メソッド customBiddingAlgorithms partners partners.targetingTypes.assignedTargetingOptions ユーザー 次のメソッドが追加されました。
サービス メソッド 広告主 次のフィールドが追加されました。
リソース フィールド MaximizeSpendBidStrategy PerformanceGoalBidStrategy 次の列挙値が追加されました。
列挙型 値 BiddingStrategyPerformanceGoalType LineItemType 次のリスト メソッドを、次のフィールドで並べ替え、フィルタできるようになりました。
メソッド フィールド advertisers.lineItems.list 次のスコープが追加され、次のサービスで使用できるようになりました。
範囲 サービス https://www.googleapis.com/auth/display-video-user-management
2020 年 6 月 24 日
パートナー チャネルと広告主チャネルの作成メソッド、新しい FirstAndThirdPartyAudience フィールド、追加の エクスチェンジ列挙型値を追加する小規模なアップデートをリリースしました。
新機能
次のサービスが追加されました。
サービス メソッド advertisers.channels partners.channels 次のフィールドが追加されました。
リソース フィールド FirstAndThirdPartyAudience 次の列挙値が追加されました。
列挙型 値 交換 次のリストメソッドを、次のフィールドでフィルタできるようになりました。
メソッド フィールド advertisers.creatives.list
2020 年 6 月 2 日
ターゲティング対象エンティティのサブセットを作成、パッチ適用、入力する機能が導入され、ターゲティング タイプ（チャネル、デジタル コンテンツ ラベルの除外、デリケートなカテゴリの除外）の 3 つについて、広告主様レベルでターゲティングを変更できるようになりました。
新機能
次のサービスが追加されました。
次のメソッドが追加されました。
サービス メソッド 広告主 advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels 次のフィールドが追加されました。
リソース フィールド 広告主 クリエイティブ insertionOrder.insertionOrderBudgetSegment
2020 年 4 月 27 日
大規模な機能セットをリリースし、API の範囲を SDF 以外にも拡大しました。広告主、キャンペーン、広告掲載オーダー、広告申込情報、クリエイティブなどのエンティティの作成、取得、更新、削除を可能にするコア リソース管理を追加しました。また、広告申込情報レベルでターゲティングを編集することもできます。
新機能
次のサービスが追加されました。
2020 年 3 月 9 日
Display & Video 360 API v1 をリリースしました。これは API の初期バージョンです。
既知の問題
なし。