サンドボックスでのコードのテスト

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 つのカタログで公開が無効になっている場合でも、別のカタログでその商品の広告が表示されることがあります。

注:

ストアの既定のカタログを更新することはできません。 既定のカタログを更新しようとすると、要求は失敗します。