Microsoft では、運用環境に展開する前にアプリケーションをテストできるコンテンツ API のサンドボックスは提供していません。
ただし、次のオプションを使用すると、ライブ データに影響を与えることなく、運用環境でアプリケーションをテストできます。 これらのオプションは、 製品 リソースと インベントリ リソースにのみ適用され、 カタログ リソースには適用されません。
ドライラン クエリ パラメーターの使用
ライブ フィードを変更したり、配信された広告に影響を与えたりせずに運用環境でコードをテストするには、以下に示すように、ド ライラン クエリ パラメーターをエンドポイント URL に含めます。
https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/{bmcMerchantId}/products/{itemUniqueId}?dry-run
dry-run を使用しても、ライブ フィードは変更されませんが、検証エラーが返されます。
ドライラン パラメーターの使用時にはデータがデータベースに格納されないため、このオプションを使用するときは、次の制限事項を考慮してください。
- 挿入操作で ID が返されない
- このサービスでは、データ品質、編集上の問題、データベース関連の検証などの二次エラー メッセージが生成および返されることはありません
カタログ リソースは dry-run クエリ パラメーターをサポートしていないことに注意してください。
公開の無効化
もう 1 つのオプションは、カタログのコンテンツを公開する機能を無効にすることです。 無効になっているカタログでは、広告は提供されません。 これにより、カタログに対して操作を実行し、発生したエラーをキャプチャできます。
Microsoft Advertising Web アプリケーションでカタログを無効にするには、[ カタログ 管理] タブからカタログを選択します。次に、[ カタログ設定 ] タブで、[ 発行を有効にする] の選択を解除します。
カタログ リソースを使用して 公開を無効にすることもできます。 詳細については、「 カタログの管理」を参照してください。
dry-run クエリ パラメーターを使用する場合と同様に、データ品質、編集上の問題、データベース関連の検証などのセカンダリ エラー メッセージは生成されず、返されません。 ただし、挿入操作では ID が返されます。
注意
商品はカタログではなく、ストア内で固有です。 同じ ID の製品が複数のカタログにある場合、無効なカタログの製品に行う変更は、有効なカタログでも反映されます。 つまり、1 つのカタログで公開が無効になっている場合でも、別のカタログでその商品の広告が表示されることがあります。
注:
ストアの既定のカタログを更新することはできません。 既定のカタログを更新しようとすると、要求は失敗します。