このページには、Display & Video 360 API のリリースノートが掲載されています。
最新の API バージョン: v3
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 以下のフィールドが追加されました。
リソース フィールド User YoutubeAndPartnersInventorySourceConfig
v2
以下のメソッドが追加されました。
サービス メソッド floodlightGroups.floodlightActivities 以下のフィールドが追加されました。
リソース フィールド User 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
次のリストメソッドの最大ページサイズが引き上げられました。
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 回のリクエストで複数の広告申込情報に割り当てられているターゲティングを編集および取得 できるようになりました。- 新しい
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 オミド 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
を更新する関数。- 利用可能なリソース ロケーションを取得し、そのロケーションにファイルをアップロードするプロセスを通じてスクリプトをアップロードする機能。
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 TargetOptions.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 以下のフィールドが追加されました。
リソース フィールド Advertiser AssignedTargetingOption TargetingOption 以下の列挙値が追加されました。
列挙型 値 AssignedTargetingOption.Recency エクスチェンジ TargetingType 以下の列挙値が、以下のフィールドに対して有効になりました。
リソース 項目 値 Advertiser 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 フィールドと新しい PlacementType 列挙値が導入され、テレビ広告掲載オーダーとオーバー ザ トップ広告申込情報を取得、管理できるようになりました。mobileApp
広告申込情報フィールドでモバイルアプリ広告申込情報を使用できるようになりました。列挙値を追加することで、エクスチェンジ、Google オーディエンス、SDF のサポートを拡張しました。最終更新日時で advertisers.list
値をフィルタリングして並べ替える機能が導入されました。
新機能
以下のフィールドが追加されました。
リソース フィールド InsertionOrder LineItem 以下の列挙値が追加されました。
列挙型 値 エクスチェンジ GoogleAudienceType LineItemType SdfVersion 以下の list メソッドを、次のフィールドで並べ替えたり、フィルタしたりできるようになりました。
メソッド フィールド 広告主
2020 年 12 月 4 日
地域ターゲティング オプションを検索し、複数のリソースリスト メソッドの結果を最終更新時刻でフィルタリングする機能が追加されました。サポートが終了した地域ターゲティングが広告申込情報で使用されていることをユーザーに知らせる新しい PlacementWarningMessage が導入されました。
新機能
以下のメソッドが追加されました。
サービス メソッド targetingTypes.targetingOptions 以下の列挙値が追加されました。
列挙型 値 エクスチェンジ 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 以下の列挙値が追加されました。
列挙型 値 エクスチェンジ 以下の 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 日
Display & Video 360 API v1 をリリースしました。これは API の初期バージョンです。
既知の問題
なし。