このページでは、Display & Video 360 API のサポート終了バージョンのリリースノートを提供します。
すべてのリリースからライブ バージョンについては、メインのリリースノートのページをご覧ください。
2024 年 12 月 4 日
新機能
Core と Tubi の Exchange 値のサポートを追加しました。
firstAndThirdPartyAudiences.list の最大許容ページサイズを 200 から 5000 に増やしました。firstAndThirdPartyAudiences.list リクエストの pageSize パラメータを更新して、割り当ての使用量をさらに最適化します。
v3
次の列挙値が追加されました。
列挙型 値 ExchangeEXCHANGE_COREEXCHANGE_TUBI次のリストメソッドの最大ページサイズが増加しました。
メソッド 新しい最大ページサイズ firstAndThirdPartyAudiences.list5000
2024 年 10 月 22 日
新機能
広告視聴単価のパフォーマンス目標のサポートを追加しました。
接続済みデバイスのターゲティングを設定および取得する機能を追加しました。
[サードパーティの検証ツールによるターゲティング] に、Adloox の新しいブランド保護設定を追加しました。
現在クローズド ベータ版の v8 構造化データファイルのダウンロードのサポートを追加しました。
v3
次のフィールドが追加されました。
オブジェクト フィールド AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContent次の列挙値が追加されました。
列挙型 値 DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
非推奨の値
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 列挙型値を変更しました。
v2 と v3 に SDF_VERSION_7 列挙値を追加し、構造化データ ファイル v7 のサポートを追加しました。
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リソースに割り当てられた位置を作成および削除できるようにします。 TargetingExpansionConfigオブジェクトのtargetingExpansionLevelフィールドを置き換える新しいブール値のenableOptimizedTargetingフィールド。advertisers.createリクエストの作成時に含める必要があるAdvertiserリソースのbillingConfigフィールドの要件と、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 有効にする
create
deactivate
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 日
新機能
非推奨の excludeFirstPartyAudience フィールドが true に設定されている場合、行アイテムの warningMessages フィールドに割り当てられる新しい LineItemWarningMessage 値を追加しました。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 フィールドを追加しました。
3 つの新しい LineItemType 値で識別される、YouTube とパートナーのオーバー ザ トップの広告申込情報の取得のサポートを追加しました。
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を使用して削除または取得できませんでした。代わりに、ユーザーが列挙値を使用することが想定されていました。この更新により、AssignedTargetingOptionリソースの新しいassignedTargetingOptionIdAliasフィールドで識別されるassignedTargetingOptionIdまたは列挙値を使用して、これらの割り当てられたターゲティング オプションを削除または取得できるようになります。 - 行アイテムの
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 回のリクエストで複数の広告申込情報の
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 日
コンテンツの長さ、ストリーム タイプ、ジャンルのターゲティングの取得と設定のサポートを追加しました。
InsertionOrder オブジェクトに billableOutcome フィールドを追加しました。
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を作成し、既存のcustomBiddingAlgorithmsを更新する関数。 - 利用可能なリソースの場所を取得し、その場所にファイルをアップロードするプロセスを通じてスクリプトをアップロードする機能。
customBiddingAlgorithms.scriptsサービス(customBiddingScriptsの取得と作成)。
広告申込情報の管理ガイドに、新しいカスタム入札を実装するページが追加されました。このページでは、カスタム入札アルゴリズムの作成、スクリプトのアップロード、カスタム入札アルゴリズムを広告申込情報の入札戦略として割り当てるプロセスについて説明しています。
SdfVersion 列挙値を追加することで、最新の SDF バージョン v5.4 のサポートを追加しました。
新機能
次のメソッドが追加されました。
サービス メソッド customBiddingAlgorithms customBiddingAlgorithms.scripts media 次の列挙値が追加されました。
列挙型 値 SdfVersion
2021 年 9 月 14 日
ターゲティング タイプ TARGETING_TYPE_BUSINESS_CHAIN と TARGETING_TYPE_POI で近隣地域ターゲティングのサポートを追加しました。
targetingTypes.targetingOptions.search を使用して、利用可能な TARGETING_TYPE_BUSINESS_CHAIN と TARGETING_TYPE_POI のターゲティング オプションを検索する機能を追加しました。これらのオプションは targetingTypes.targetingOptions.get メソッドまたは targetingTypes.targetingOptions.list メソッドで取得できないためです。
カスタム入札アルゴリズム リソースに新しい 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 users 次のメソッドが追加されました。
サービス メソッド 広告主 次のフィールドが追加されました。
リソース フィールド MaximizeSpendBidStrategy PerformanceGoalBidStrategy 次の列挙値が追加されました。
列挙型 値 BiddingStrategyPerformanceGoalType LineItemType 次のリストメソッドで、次のフィールドによる並べ替えとフィルタリングが可能になりました。
メソッド フィールド advertisers.lineItems.list 次のサービスで使用するスコープが追加されました。
スコープ サービス https://www.googleapis.com/auth/display-video-user-management
2020 年 6 月 24 日
パートナー チャネルと広告主チャネルの作成メソッド、新しい FirstAndThirdPartyAudience フィールド、追加の exchange 列挙値を追加する小規模なアップデートをリリースしました。
新機能
次のサービスが追加されました。
サービス メソッド advertisers.channels partners.channels 次のフィールドが追加されました。
リソース フィールド FirstAndThirdPartyAudience 次の列挙値が追加されました。
列挙型 値 交換 次のリストメソッドは、次のフィールドでフィルタリングできるようになりました。
メソッド フィールド advertisers.creatives.list
2020 年 6 月 2 日
ターゲティング可能なエンティティのサブセットを作成、パッチ適用、入力する機能が導入され、3 つのターゲティング タイプ(チャネル、デジタル コンテンツ ラベルの除外、デリケートなカテゴリの除外)について、広告主レベルのターゲティングを変更する機能が追加されました。
新機能
次のサービスが追加されました。
次のメソッドが追加されました。
サービス メソッド 広告主 advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels 次のフィールドが追加されました。
リソース フィールド 広告主 creative insertionOrder.insertionOrderBudgetSegment
2020 年 4 月 27 日
大規模な機能セットをリリースし、API の範囲を SDF を超えて拡大しました。広告主、キャンペーン、広告掲載オーダー、広告申込情報、クリエイティブなどのエンティティの作成、取得、更新、削除を可能にするコア リソース管理を追加しました。また、新しい機能では、広告申込情報レベルでターゲティングを編集することもできます。
新機能
次のサービスが追加されました。
2020 年 3 月 9 日
Display & Video 360 API v1 をリリースしました。これは API の初期バージョンです。
既知の問題
なし。