Yahoo!広告 API | Developer Center

English

Yahoo!広告 検索広告 API v19 リリースノート

リリースバージョン

v19

リリース日

2026年2月25日（水）

本リリースの主な内容

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

年齢・性別を指定したターゲティング機能の追加とターゲットリストの名称変更

性別および年齢を指定したターゲティング機能に対応しました。また、これと併せて「ターゲットリスト」の名称を「オーディエンスリスト」に変更しました。
実際に機能が利用可能となる時期などの詳細は、以下を参照してください。
【検索広告】年齢・性別を指定したターゲティング機能の追加とターゲットリストの名称変更

対象ウェブサービス

＜ターゲットリストの名称変更＞

  • AudienceListService（旧RetargetingListService）
  • AdGroupAudienceListService（旧 AdGroupRetargetingListService）
  • CampaignAudienceListService（旧 CampaignRetargetingListService）
  • ReportDefinitionService
  • AuditLogService
  • AbTestService
  • AdGroupService
  • CampaignService

＜年齢・性別を指定したターゲティング＞

  • AudienceListService（旧RetargetingListService）
  • AdGroupAudienceListService（旧 AdGroupRetargetingListService）
  • CampaignAudienceListService（旧 CampaignRetargetingListService）
  • ReportDefinitionService

変更内容

＜ターゲットリストの名称変更＞

  • 以下のサービス名称を変更しました（これ以降の説明は新しいサービス名称で記載します）。
    • 「RetargetingListService」→「AudienceListService」
    • 「AdGroupRetargetingListService」→「AdGroupAudienceListService」
    • 「CampaignRetargetingListService」→「CampaignAudienceListService」
  • 「ターゲットリスト」「リターゲティングリスト」などの文言を「オーディエンスリスト」へ変更しました。バージョンごとの変更対象は以下のとおりです。
    • V19
      サービス名、カラム名、エラー文言、リファレンスなど全て
    • V18以前のバージョン
      エラー文言、リファレンス
  • ReportDefinitionServiceのレポートタイプに、オーディエンスリストに名称・内容を変更した Enumを追加しました。
    また、従来のEnumは次期バージョン以降で廃止予定です。
  • AuditlogServiceのエンティティタイプを、以下のとおり変更しました。
    • 「NEGATIVE_CAMPAIGN_USER_LIST」→「NEGATIVE_CAMPAIGN_AUDIENCE_LIST」
    • 「NEGATIVE_AD_GROUP_USER_LIST」→「NEGATIVE_AD_GROUP_AUDIENCE_LIST」
    • 「AD_GROUP_USER_LIST」→「AD_GROUP_AUDIENCE_LIST」
    • 「TARGET_LIST」→「AUDIENCE_LIST」

＜年齢・性別を指定したターゲティング＞

※本機能は一部のユーザーを対象に提供いたします。提供対象外のユーザーの場合、AudienceListService/getDemographicでは空のレスポンスが返却されます。なお、詳細な提供条件は非開示となります。
※本機能は別途ご案内している「【検索広告】年齢・性別を指定したターゲティング機能の追加とターゲットリストの名称変更」のリリース後にご利用になれます。

  • AudienceListService/getDemographic
    • 年齢、性別ごとのオーディエンスリスト（旧ターゲットリスト）を選択できるようになりました。
  • AdGroupAudienceListService/get, add, set
    • criterionUserList配下に年齢、性別ごとのオーディエンスリスト（旧ターゲットリスト）かどうかを示すフラグを追加しました。
  • CampaignAudienceListService/add
    • 年齢、性別ごとのオーディエンスリスト（旧ターゲットリスト）を追加しようとした場合、「Invalid value」が返却されます。
  • ReportDefinitionService/get, add, remove, getReportFields
    • レポート種別が「CAMPAIGN_AUDIENCE_LIST」「ADGROUP_AUDIENCE_LIST」の場合、fieldに「配信対象ユーザー（英語名：Target audience、フィールド名：TARGET_ALL）」を指定できるようになりました。
    • レポート種別が「CAMPAIGN_ASSET」の場合、fieldに「ビジネス名（英語名：Business Name、フィールド名：BUSINESS_NAME）」を指定できるようになりました。
    • レポート種別が「ASSET_COMBINATIONS」の場合、fieldに「配信ビジネス名（英語名：Deliverd Business Name、フィールド名：DELIVERED_BUSINESS_NAME）」を指定できるようになりました。

広告表示アセットにおけるビジネス名アセットの追加とアカウントへの関連付け

広告表示アセットに新たに追加される「ビジネス名アセット」、およびアカウント単位での関連付けに対応しました。
実際に機能が利用可能となる時期などの詳細は、以下を参照してください。
【検索広告】ビジネス名アセットの追加について
【検索広告】広告表示アセットでアカウントへの関連付けに対応

対象ウェブサービス

  • AccountAssetService（新規追加）
  • AssetService
  • CampaignAssetService
  • ReportDefinitionService
  • CampaignExportService
  • AuditLogService

変更内容

  • 新規ウェブサービス「AccountAssetService」を追加しました。
  • AssetService/get, add, set, remove
    assetData/typeに「BUSINESS_NAME」を追加しました。
  • CampaignAssetService/get, replace, set
    typeに「BUSINESS_NAME」を追加しました。
  • ReportDefinitionService/get, add, remove
    reportTypeに「ACCOUNT_ASSET」を追加しました。
  • CampaignExportService/add
    entityTypesに「BUSINESS_NAME_ASSET」を追加しました。
  • AuditLogService/get, add
    entityTypeに「ACCOUNT_ASSET」を追加しました。

新しいレポート指標「クリックシェア」の追加

新しいレポート指標「クリックシェア」を追加しました。
本件の詳細は以下を参照してください。
【検索広告】新しいレポート指標「クリックシェア」追加のお知らせ

対象ウェブサービス

  • ReportDefinitionService

変更内容

  • ReportDefinitionService/get, add, remove, getReportFields
    fieldに「クリックシェア（英語名： Click share、フィールド名： SEARCH_CLICK_SHARE）」を指定できるようになりました。

検索広告（ショッピング） オーディエンスリスト機能に対応

検索広告（ショッピング）におけるオーディエンスリスト機能の提供に合わせて、オーディエンスレポートの出力に対応しました。
実際に機能が利用可能となる時期などの詳細は、以下を参照してください。
【検索広告（ショッピング）】オーディエンスリストターゲティング機能の追加について

対象ウェブサービス

  • SsaReportDefinitionService

変更内容

  • reportTypeに「AUDIENCE_LIST」を追加しました。

v18とv19のIF差分

こちらのページで検索広告 API v18とv19の差分をIF単位でご覧いただけます。

旧バージョンの終了について

Yahoo!広告 APIv17の提供を以下の日程で終了します。

  • サポート終了日：2026年3月17日（火）（予定）
  • システム終了日：2026年7月28日（火）（予定）

また、Yahoo!広告 APIv16の提供を以下の日程で終了します。

  • システム終了日：2026年3月17日（火）
    ※サポートは終了済みです。

Developer Center

関連サイト