Yahoo!広告 API | Developer Center
English2021/01/25
Yahoo!広告 API v4 システムリリースについて
文書管理番号：APIJ-FY20-2157
お客様各位
平素は弊社サービスに多大なるご支援を賜り、厚く御礼申し上げます。
このたび弊社では、Yahoo!広告 APIの新バージョンをリリースします。詳細を
下記のとおりお知らせいたしますので、ご確認ください。
今後ともYahoo!広告をよろしくお願いいたします。
記
1. 対象サービス：
Yahoo!広告 検索広告 API
Yahoo!広告 ディスプレイ広告 API
2. リリースのバージョン：
v4
3. 実施日（予定）：
2021年2月24日（水）
※日程は変更になる場合があります。
4. 検索広告 APIの変更点：
■MCCアカウント対応
MCCアカウントの検索、参照、変更に対応します。
※広告管理ツールではすでに提供中の機能です。詳細は以下のリリースノート
を参照してください。
【Yahoo!広告】MCCアカウントの提供開始について
https://promotionalads.yahoo.co.jp/support/release/857376.html
これに伴い、以下の変更を実施します。
・AccountLinkServiceを新設し、/get でmanagerAccountIdの取得に対応
・AccountServiceからmanagerAccountIdを削除
■レポート関連の変更
ReportDefinitionServiceで、フィルター条件の項目名を変更します。
変更前 → 変更後
reportOperator → filterOperator
value → values
■提案系サービスの変更
提案系サービスで、以下の変更を実施します。
・KeywordPlanIdeaServiceを新設
・TargetingIdeaServiceを削除
※KeywordPlanIdeaServiceで同等の機能を提供予定
・提案系サービスのQPSを「最大1件/秒」に変更
■保守改善
・キーワードの逆引きに対応します。
AdGroupCriterionService/get時にキーワード（語句）、キーワードマッチ
タイプ、広告グループIDを指定することで、キーワードIDを取得可能になり
ます。
・ダウンロードファイルの文字コードを示すEnumについて、値の一部を変更
して表現を統一します。
対象は以下のサービスです。
ReportDefinitionService
AuditLogService
CampaignExportService
PageFeedItemService
・PageFeedItemServiceのaddDownloadJobで、リクエストのインターフェース
を変更します。
5. ディスプレイ広告 APIの変更点：
■MCCアカウント対応
MCCアカウントの検索、参照、変更に対応します。
※広告管理ツールではすでに提供中の機能です。詳細は以下のリリースノート
を参照してください。
【Yahoo!広告】MCCアカウントの提供開始について
https://promotionalads.yahoo.co.jp/support/release/857376.html
これに伴い、以下の変更を実施します。
・AccountLinkServiceを新設し、/get でmanagerAccountIdの取得に対応
・AccountServiceからmanagerAccountIdを削除
■動画の再生完了率の取得
StatsServiceで動画の再生完了率を取得できるようになります。
※広告管理ツールではすでに提供中の機能です。詳細は以下のリリースノート
を参照してください。
【ディスプレイ広告】統計項目「動画の再生完了率」追加のお知らせ
https://promotionalads.yahoo.co.jp/support/release/870177.html
■レポート関連の変更
ReportDefinitionServiceにおいて、以下の変更を実施します。
・レポートの「ヘッダ行」「合計行」の有無を指定可能に
・小数点を含む数値項目の表示タイプを「全て表示」「簡易表示」から選択
可能に
・返却する項目名の「動画の平均再生開始率」を「動画の平均再生率」に変更
・ダウンロードファイルの文字コードを示すEnumについて、値の一部を変更
して表現を統一
■保守改善
今後の機能追加のため、以下の各サービスについて変更を実施します。
機能追加の詳細は、決まり次第お知らせします。
PlacementUrlListService
ReportDefinitionService
SearchKeywordIdeaService
StatsService
6. 補足：
・各機能に関する詳細は、リリース時に公開されるリリースノート、および
リファレンスをご確認ください。
・リリースに合わせて、API v4の概要などをお伝えするオンラインセミ
ナーを開催する予定です。詳細は別途お知らせします。
7. 旧バージョンの終了について：
Yahoo!広告 API v2の提供を、以下の日程で終了します。
サポート終了日：2021年3月22日（月）
システム終了日：2021年7月20日（火）
また、「Yahoo!広告 API v3 システムリリース完了のお知らせ」（文書管理番
号：APIJ-FY20-2101）でお伝えしたとおり、Yahoo!広告 API v1を以下の日程
で終了します。
システム終了日：2021年3月22日（月）
※サポートは終了済みです。
以上