Yahoo!広告 API | Developer Center

English

検索広告 API v10 リリースノート

リリースバージョン

v10

リリース日

2023年2月14日（火）

本リリースの主な内容

※オブジェクトなどの詳細は、リファレンスをご確認ください。

1.自動入札の目標値に削除フラグを追加

自動入札「コンバージョン数の最大化」および「コンバージョン価値の最大化」の目標値に削除フラグを追加しました。

対象サービス

CampaignService
AdGroupService

内容

  • CampaignServiceに以下のフィールドを追加しました。
    maximizeConversionsBiddingScheme.isRemoveTargetCpa
    maximizeConversionValueBiddingScheme.isRemoveTargetRoas
    現在、自動入札の目標値をnullにすると値が削除されますが、今後、nullの場合は削除せず値も変更しません。削除したい場合は上記の削除フラグをオンにします。

  • AdGroupServiceに以下のフィールドを追加しました。
    maximizeConversionsBiddingScheme.isRemoveTargetCpa
    maximizeConversionValueBiddingScheme.isRemoveTargetRoas
    targetCpaBiddingScheme.isRemoveTargetCpa
    現在、自動入札の目標値を0にすると値が削除されますが、今後、0の場合は削除せず値も変更しません。削除したい場合は上記の削除フラグをオンにします。

2. インターフェースの統一

Yahoo!広告 検索広告 APIとYahoo!広告 ディスプレイ広告APIの複数のサービスでインターフェースを統一するため、検索広告 APIのフィールド名の変更や削除などの変更を行いました。

対象サービス

ConversionTrackerService
CampaignService
AdGroupService
AdGroupAdService
AccountService
BudgetOrderService
LabelService
ReportDefinitionService
AuditLogService
CampaignExportService
PageFeedItemService

内容

・フィールド名の変更

サービス名変更前のフィールド名変更後のフィールド名
ConversionTrackerService appPostbackUrlClearFlag isRemoveUrl
CampaignService containsLabelId containsLabel（※）
appStore appOsType
AdGroupService containsLabelId containsLabel（※）
bid biddingStrategyConfiguration.biddingScheme.cpcBiddingScheme
AdGroupAdService containsLabelId containsLabel（※）

（※）ENUM値からboolean値に変更

・フィールドの削除

サービス名削除するフィールド
CampaignService budget.budgetPeriod
AdGroupService bid.bidSource
targetRoasOverride
targetCpaOverride

・フィールドの新規追加

サービス名新規追加するフィールド
AdGroupService biddingStrategyConfiguration
biddingStrategyConfiguration.portfolioBiddingId
biddingStrategyConfiguration.biddingScheme.biddingStrategyType
biddingStrategyConfiguration.biddingScheme

isRemoveTrackingUrl
※trackingUrlを削除できます

・その他の変更

サービス名変更内容
AccountService

以下のmaximumとdefaultを500に変更
・accountIds[]
・numberResults
BudgetOrderService
LabelService numberResultsのdefaultを2000に変更
AdGroupAdService

ad.description1とad.headline1を削除し、以下を追加
・AppAd.headline
・AppAd.description
・DynamicSearchLinkedAd.description
・ExtendedTextAd.headline
・ExtendedTextAd.description
・TextAd.headline
・TextAd.description
ReportDefinitionService

・canFilterをfilterableに変更
・canSelectをselectableに変更
AuditLogService

AuditLogService/addJobのエンドポイントをAuditLogService/addに修正
CampaignExportService

CampaignExportService/addJobのエンドポイントをCampaignExportService/addに修正
PageFeedItemService

PageFeedItemService/addDownloadJobのエンドポイントをPageFeedItemService/addに修正

3. 保守改善

今後の機能追加のため、以下のサービスにフィールドやENUM値を追加しました。機能追加の詳細については、追ってお知らせします。

対象サービス

AdGroupAdService

内容

  • adに以下を追加

    reviewCustomParameters
    reviewFinalUrl
    reviewSmartphoneFinalUrl
    reviewTrackingUrl
    isRemoveSmartphoneFinalUrl
    isRemoveTrackingUrl

  • responsiveSearchAdに以下の変更を実施

    reviewHeadlines[], reviewDescriptions[], reviewPath1, reviewPath2, isRemovePath1, isRemovePath2を追加
    headlines[], descriptions[]にactiveStatusを追加
    headlines[], descriptions[]のapprovalStatusにPOST_DISAPPROVEDとAPPROVED_WITH_REVIEWを追加

検索広告 API v8の提供終了について

以下の日程で検索広告 API v8のシステムの提供を終了いたします。

  • サポート終了日： 2023年2月27日（月）

  • システム終了日： 2023年6月23日（金）

また、以前にお伝えしたとおり、検索広告 API v7を以下の日程で終了します。

  • システム終了日： 2023年2月27日（月）
    ※サポートは終了済みです。

Developer Center

関連サイト