スポンサードサーチAPI V201909
V201909(WSDLバージョン V201909)
※対象データオブジェクトとEnumerationは、データオブジェクト(Enumeration)集をご確認ください。
広告とクイックリンクオプションについて、商標の使用制限が解除されているかを一括で確認できるようになりました。
商標の使用制限が解除されている場合は、「AdGroupAdService」および「FeedItemService」に制限が解除された旨の値が返却されます。
広告管理ツールでは2019年5月に提供を開始しました。詳細は以下のお知らせをご覧ください。
広告文への商標の使用制限 正式提供開始のお知らせ
検索結果ページの目標掲載位置 (PageOnePromotedBiddingScheme) を削除しました。
広告管理ツールでは2019年4月に提供を終了しました。詳細は以下のお知らせをご覧ください。
「検索結果ページの目標掲載位置」の提供終了およびデータの自動移行のお知らせ
レポートフィールドの「AVG_DELIVER_RANK」(平均掲載順位)を削除しました。削除後の値は、一律「--」(ハイフン2つ)として取得、表示されます。
また、トラッキングURLなどの新規入稿および編集時に{adposition}が利用できなくなります。入稿済みのパラメータについては{adposition}のトラッキングが不可となり、空の文字列が返ります。なお、広告配信には影響はありません。
トラッキングURLの{adposition}については以下を参照してください。
トラッキングパラメータ
詳細については以下のお知らせをご覧ください。
パフォーマンスデータ一部指標提供終了のお知らせ
自動入札の「ポートフォリオ入札設定」で設定可能な「自動入札タイプ:クリック数の最大化」(TARGET_SPEND)のうち、「spendTarget」を削除しました。
なお、下位バージョン(V201808, V201901)で「spendTarget」を設定すると、バリデーションエラーとなります。
広告管理ツールでは2019年7月25日に提供を終了しました。詳細は以下のお知らせをご覧ください。
自動入札タイプの一部設定項目終了のお知らせ
「ReportService」を「ReportDefinitionService」に統合しました。統合に伴い、定期レポートが作成できなくなります。
また、2019年12月19日(木)に、下位バージョン(V201808, V201901)における定期レポートのintervalTypeをONETIMEに変更します。これにより、定期レポートの実行はすべて停止されます。
詳細は以下の仕様ドキュメントをご覧ください。
- 拡張クイックリンクの提供開始
クイックリンクオプションに説明文を表示できるようになります(拡張クイックリンク)。それに伴い、「FeedItemPlaceholderField」に 以下の項目を追加します。
・ LINK_DESCRIPTION_1:クイックリンク説明文1
・ LINK_DESCRIPTION_2:クイックリンク説明文2
なお、クイックリンク説明文を設定する場合は、「LINK_DESCRIPTION_1」「LINK_DESCRIPTION_2」の両方に入力する必要があります。どちらか 一方だけ入力した場合はエラーとなります。 - 配信先デバイスの廃止
広告表示オプションを関連付ける際に設定する「配信先デバイス」の提供を終了します。これにより、2019年10月2日以降は、「CampaignFeed」「AdGroupFeed」 の「DevicePlatform」は設定できなくなります。なお、2019年12月頃に「DevicePlatform」は利用不可になる予定です。
広告管理ツールでは2019年10月2日(水)のリリースを予定しております。詳細は以下のお知らせをご覧ください。
スポンサードサーチ クイックリンクオプションの機能追加について
- WSDL「AuditLogService」を修正しました。
- 「LocationService」を廃止しました。
- 「FeedItem」の検索条件に「feedFolderId」を追加しました。
- 広告管理ツールで操作した履歴を含めた操作履歴をAPIでも取得可能になりました。 ※「Serviceの変更による各Versionへの影響」の項目もあわせてご確認ください。
Service | V201901以前 | V201909 |
---|---|---|
CampaignService |
・入札設定に「検索結果ページの目標掲載位置」(PageOnePromotedBiddingScheme)を設定すると、バリデーションエラーとなる ・「目標予算」(spendTarget)を設定すると、バリデーションエラーとなる |
・入札設定から「検索結果ページの目標掲載位置」(PageOnePromotedBiddingScheme)の項目削除 ・「目標予算」(spendTarget)の項目削除 |
BiddingStrategyService |
・入札設定に「検索結果ページの目標掲載位置」(PageOnePromotedBiddingScheme)を設定すると、バリデーションエラーとなる ・「目標予算」(spendTarget)を設定すると、バリデーションエラーとなる |
・入札設定から「検索結果ページの目標掲載位置」(PageOnePromotedBiddingScheme)を削除 ・「目標予算」(spendTarget)の項目削除 |
AdGroupAdService |
・使用制限が解除されているか一括で確認できない |
・使用制限が解除されているか一括で確認できる |
FeedItemService |
・使用制限が解除されているか一括で確認できない ・検索条件にfeedFolderIdを指定できない |
・使用制限が解除されているか一括で確認できる ・検索条件にfeedFolderIdを指定できる |
AuditLogService |
・最小値を設定するとバリデーションエラーとなる ・広告管理ツールの操作履歴は取得できない |
・最小値を設定するとバリデーションエラーとなる(対象箇所が異なるだけなので、特に影響はありません) ・広告管理ツールの操作履歴が取得可能 |
ReportDefinitionService |
・ReportDefinitionService/ReportServiceを利用してレポートを作成 ・定期レポートの作成は可能 ・平均掲載順位を選択可能 |
・ReportDefinitionServiceのみを利用してレポートを作成 ・定期レポートの作成は不可 ・平均掲載順位は選択可能だが、「--」と表示される |
ReportService |
・ReportDefinitionService/ReportServiceを利用してレポートを作成 ・平均掲載順位が「--」になる |
・ReportServiceはReportDefinitionServiceに統合 |
LocationService | ・LocationServiceの利用は任意。 | ・LocationServiceは廃止。 |
以下の日程でスポンサードサーチAPI V201808のサポート、およびシステムの提供を終了いたします。
- サポート終了日:2019年10月17日(木)
- システム終了日:2019年12月19日(木)