このページには、ディスプレイ &ビデオ 360 API のリリースノートが掲載されています。
最新の API バージョン: v3
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_PROXIMITY
LocationList
リソースに割り当てられたロケーションを作成および削除できます。 - 新しいブール値
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_PROXIMITY
LocationList
リソースの作成がサポートされるようになりました。advertisers.locationLists.patch TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
リソースの更新がサポートされるようになりました。advertisers.locationLists.assignedLocations.bulkEdit TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
リソースのAssignedLocation
リソースの一括編集がサポートされるようになりました。advertisers.locationLists.assignedLocations.create TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
リソースでAssignedLocation
リソースを作成できるようになりました。次のクエリ パラメータが追加されました。
メソッド パラメータ inventorySources.get 次のフィールドが必須になりました。
リソース フィールド Advertiser 以下のフィールドが追加されました。
リソース フィールド 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 を公開ベータ版から一般提供に移行しました。
新しい assignedTargetingOptionIdAlias
フィールドを AssignedTargetingOption
リソースに追加しました。このフィールドは、ターゲティングの取得時と削除時に assignedTargetingOptionId
の代わりに使用できます。このフィールドは、列挙型によって割り当てられたターゲティング タイプの、割り当てられたターゲティング オプションに対してのみ設定されます。エイリアス値は、関連する列挙値として文字列です。
新しい billingConfig
フィールドを Advertiser
リソースに追加しました。
3 つの新しい LineItemType
値で識別される、YouTube とパートナーのオーバー ザ トップ広告申込情報を取得するためのサポートが追加されました。
v1 と v2 の多数の list
メソッドについて、最大ページサイズを 200 に増やしました。デフォルトのページサイズは変更されていません。
v2
以下のフィールドが追加されました。
リソース フィールド Advertiser 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
次の list メソッドで、最大ページサイズが引き上げられました。
v1
次の list メソッドで、最大ページサイズが引き上げられました。
既知の問題
このアップデートでは、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 回のリクエストで、複数の広告申込情報にわたって割り当てられたターゲティングの編集と取得 が可能になりました。- 新しい
bulkUpdate
メソッドを使用すると、1 回のリクエストで複数の広告申込情報のentityStatus
を更新できます。 - 新しいターゲティング ロジックでは、
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 partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions 次のターゲティング タイプの
AssignedTargetingOption
リソースは、v2 のターゲティングの割り当てに列挙型を使用します。v2 では、これらのターゲティング タイプのAssignedTargetingOption
リソースのassignedTargetingOptionId
フィールドが、列挙型値の文字列バージョンを使用するように更新されました。ターゲット タイプ 列挙型 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 次の list メソッドを、次のプロパティでフィルタできるようになりました。
メソッド フィールド 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
を作成し、既存の値を更新する関数です。 - 使用可能なリソース ロケーションを取得し、そのロケーションにファイルをアップロードするプロセスを通じてスクリプトをアップロードする機能。
customBiddingScripts
を取得して作成する新しい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 次の list メソッドを、次のプロパティでフィルタできるようになりました。
メソッド フィールド customBiddingAlgorithms.list
2021 年 8 月 4 日
ターゲティング タイプ TARGETING_TYPE_OMID
に Open Measurement 対応の広告枠のターゲティングがサポートされるようになりました。
pageSize
メソッド パラメータを使用して、さまざまな広告主、キャンペーン、広告掲載オーダー、広告申込情報に割り当てられたターゲティング オプション リスト メソッドについて、1 ページで返すことができる、割り当て済みターゲティング オプションの最大数を増やしました。
新機能
以下のフィールドが追加されました。
リソース フィールド AssignedTargetingOption TargetingOption 次の列挙値が追加されました。
列挙型 値 TargetingType 次の list メソッドで、最大ページサイズが引き上げられました。
2021 年 5 月 26 日
advertisers.invoices
サービスをリリースしました。これにより、ユーザーは次のことができます。
- 特定の月に広告主に発行された請求書を取得する。
- ある月に広告主が使用した通貨コードを調べる。
キャンペーン リソースに campaignBudgets
フィールドを追加しました。広告掲載オーダーの予算セグメントをキャンペーンの予算にリンクして、関連するセグメントの合計予算をキャンペーンの合計予算額に制限できます。
新しいターゲティング タイプ TARGETING_TYPE_NATIVE_CONTENT_POSITION
で、ネイティブ コンテンツの位置ターゲティングがサポートされるようになりました。
広告主リソースに新しい prismaEnabled
フィールドが導入され、Mediaocean の Prisma ツールとの統合が可能になりました。
広告主の entityStatus
フィールドに対する ENTITY_STATUS_PAUSED
列挙値のサポートを有効にしました。
新機能
以下のメソッドが追加されました。
サービス メソッド advertisers.invoices 以下のフィールドが追加されました。
リソース フィールド Advertiser AssignedTargetingOption TargetingOption 次の列挙値が追加されました。
列挙型 値 AssignedTargetingOption.Recency Exchange TargetingType 次の列挙値が次のフィールドで有効になりました。
リソース 項目 値 Advertiser entityStatus ENTITY_STATUS_PAUSED
2021 年 4 月 29 日
チャネル リソースと除外キーワード リスト リソースに新しいフィールドを追加しました。これらのリソースは、ターゲティングにリソースを使用して広告申込情報の数を返します。広告申込情報リストメソッドの新しい filter
プロパティが有効になりました。これにより、ユーザーはターゲティングで特定のチャネルまたは除外キーワード リストを使用している広告申込情報のみを取得できます。
新機能
以下のフィールドが追加されました。
リソース フィールド 水路 次の list メソッドを、次のプロパティでフィルタできるようになりました。
メソッド フィールド advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
2021 年 3 月 30 日
デフォルト設定を使用して広告申込情報を生成する新しいメソッドを広告申込情報サービスに追加しました。これらのデフォルト値は、指定された広告申込情報タイプ、親広告掲載オーダーの設定と割り当て済みターゲティングに基づきます。
新しいキャンペーン ターゲティング サービスと追加の一括リスト方法を使用して、キャンペーンのターゲティングを取得できるようになりました。
アプリのターゲティングが拡張され、より多くのプラットフォームでアプリをターゲットに設定できるようになりました。
advertisers.channels.sites
、partners.channels.sites
、advertisers.negativeKeywordLists.negativeKeywords
サービスに複数の変更を加えて、チャンネルと除外キーワード リストの内容を簡単に管理できるようにしました。主な変更点は次のとおりです。
replace
メソッドが追加されました。これにより、ユーザーはチャンネルまたは除外キーワード リストの既存のコンテンツを完全に上書きできます。- 一括編集リクエストの
createdSites
フィールドまたはcreatedNegativeKeywords
フィールドに既存のアイテムが含まれていないという要件の廃止。 - サイトの一覧表示または除外キーワードの一覧表示のレスポンスで、1 ページで返されるアイテムの最大数の増加。
新機能
以下のメソッドが追加されました。
以下のフィールドが追加されました。
リソース フィールド AssignedTargetingOption.AppAssignedTargetingOptionDetails 次の list メソッドで、最大ページサイズが引き上げられました。
メソッド 以前の最大ページサイズ 新しい最大ページサイズ 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 次の列挙値が追加されました。
列挙型 値 Exchange GoogleAudienceType LineItemType SdfVersion 以下の list メソッドで、以下のフィールドで並べ替えとフィルタができるようになりました。
メソッド フィールド 広告主
2020 年 12 月 4 日
地域ターゲティング オプションを検索し、リソースリスト メソッドの結果を最終更新日時でフィルタリングする機能が追加されました。新しい LineItemWarningMessage を導入し、広告申込情報でサポート終了の地域ターゲティングが使用されていることをユーザーに通知しました。
新機能
以下のメソッドが追加されました。
サービス メソッド targetingTypes.targetingOptions 次の列挙値が追加されました。
列挙型 値 Exchange LineItemWarningMessage 以下の list メソッドで、以下のフィールドで並べ替えとフィルタができるようになりました。
メソッド フィールド 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 次の list メソッドを、次のフィールドでフィルタできるようになりました。
メソッド フィールド advertisers.lineItems.list
2020 年 10 月 12 日
取得可能な警告メッセージを広告申込情報リソースとクリック率(CTR)のパフォーマンス目標タイプに追加しました。広告申込情報を一覧表示するときにフィルタ可能なフィールドとして warningMessages
を追加しました。
新機能に加えて、新しい割り当て上限が有効になり、バッチ リクエストの使用に関する新しいドキュメントが利用可能になりました。
新機能
以下のフィールドが追加されました。
リソース フィールド LineItem 次の列挙値が追加されました。
列挙型 値 PerformanceGoalType 次の list メソッドを、次のフィールドでフィルタできるようになりました。
メソッド フィールド advertisers.lineItems.list
2020 年 8 月 28 日
広告主監査メソッドのレスポンスに新しいフィールドを追加し、さまざまなリストメソッドに新しいフィルタ可能なフィールドを追加しました。
新機能
以下のフィールドが追加されました。
リソース フィールド Advertiser.Audit レスポンス本文 次の list メソッドを、次のフィールドでフィルタできるようになりました。
メソッド フィールド advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
2020 年 8 月 4 日
新しいユーザー管理、パートナー、パートナー ターゲティング サービスをリリースしました。アカウント エンティティ数の上限に達することを事前に防ぐためのツールを導入しました。オーディオ広告申込情報がサポートされるようになりました。また、広告申込情報と広告掲載オーダーの入札戦略でカスタム入札アルゴリズムを使用できるようになりました。
新機能
次のサービスが追加されました。
サービス メソッド customBiddingAlgorithms パートナー partners.targetingTypes.assignedTargetingOptions ユーザー 以下のメソッドが追加されました。
サービス メソッド 広告主 以下のフィールドが追加されました。
リソース フィールド MaximizeSpendBidStrategy PerformanceGoalBidStrategy 次の列挙値が追加されました。
列挙型 値 BiddingStrategyPerformanceGoalType LineItemType 以下の list メソッドで、以下のフィールドで並べ替えとフィルタができるようになりました。
メソッド フィールド advertisers.lineItems.list 次のサービスで使用するために、次のスコープが追加されました。
範囲 サービス https://www.googleapis.com/auth/display-video-user-management
2020 年 6 月 24 日
パートナー チャネルと広告主チャネル用の create メソッド、新しい FirstAndThirdPartyAudience フィールド、追加の exchange 列挙値を追加する小規模なアップデートをリリースしました。
新機能
次のサービスが追加されました。
サービス メソッド advertisers.channels partners.channels 以下のフィールドが追加されました。
リソース フィールド FirstAndThirdPartyAudience 次の列挙値が追加されました。
列挙型 値 Exchange 次の list メソッドを、次のフィールドでフィルタできるようになりました。
メソッド フィールド 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 日
ディスプレイ &ビデオ 360 API v1 をリリースしました。これは API の初期バージョンです。
既知の問題
なし。