手順5： カタログを本番環境にアップロードする

Amazonでカタログが承認されたら、ステージング環境から本番環境に移行します。カタログがAmazonの承認審査に合格すると、Amazonの担当者によって、カタログを本番環境に送信するための権限が開発者のアカウントに付与されます。この手順までは、アップロードできる先はstaging/パスだけです。

本番環境へのアクセスが有効になったことをAmazonの担当者が確認したら、本番環境へのカタログの送信と継続的なカタログの変更を開始できます。

本番環境のカタログの送信

本番環境へのアクセスが有効になったら、承認されたカタログを本番環境にアップロードできます。

カタログを送信するには

1. カタログファイルを本番環境にアップロードします。

   aws s3 cp my-catalog.xml.zst \
     s3://amazon-media-catalogs/<プロバイダー>/prod/catalogs/catalog-20250420.xml.zst
   

2. 本番環境のマニフェストを作成してアップロードします。

   {
       "s3Bucket": "amazon-media-catalogs",
       "s3Keys": [
           "<プロバイダー>/prod/catalogs/catalog-20250420.xml.zst"
       ],
       "type": "CATALOG_FULL",
       "schema": "EMBER"
   }
   

   aws s3 cp prod-manifest.manifest \
     s3://amazon-media-catalogs/<プロバイダー>/prod/manifests/prod-manifest-20250420.manifest
   

3. prod/reports/にある本番環境の統合レポートを確認します。
4. デバイスでコンテンツが表示されることを確認します。これで、すべてのユーザーがコンテンツを表示できるようになります。

継続的なメンテナンスの確立

本番環境のカタログが公開された後は、カタログを定期的に更新して最新の状態に保つ必要があります。

更新頻度

次の表は、カタログの更新に求められる送信頻度を説明したものです。

Amazonでは、カタログを最新の状態に保ち、最適なユーザーエクスペリエンスを提供するために、次の頻度で更新することを推奨しています。

• 毎日： 新しいリリース、スケジュールの更新、配信状況の変更
• 毎週： メタデータの修正、画像の更新、インクリメンタル更新
• 毎月： 完全なカタログの再構築と検証

更新戦略

カタログを維持するには、インクリメンタル更新、カタログの完全な置き換え、特定のアイテムの削除を定期的に実行します。

action属性（upsertまたはreplace）とDelete要素に関する詳細なドキュメントについては、削除とカタログアクションを参照してください。ここには、バージョンに基づく削除ルールや階層の削除順序についての説明も含まれています。

インクリメンタル更新

インクリメンタル更新は最も一般的な更新タイプです。マニフェストでCATALOG_UPDATEを使用し、カタログでaction="upsert"を指定します。action属性を省略すると、デフォルトでupsertになります。

<ProgramCatalog id="MY_CATALOG" version="1" action="upsert">
    <Movie id="NEW_MOVIE" version="1"><!-- ... --></Movie>       <!-- 追加 -->
    <Movie id="EXISTING_MOVIE" version="3"><!-- ... --></Movie>  <!-- 更新 -->
    <Delete id="EXPIRED_MOVIE" version="10"/>                    <!-- 削除 -->
    <!-- 変更のない映画は影響を受けません。 -->
</ProgramCatalog>

{
    "s3Bucket": "amazon-media-catalogs",
    "s3Keys": ["<プロバイダー>/prod/catalogs/incremental-20250421.xml.zst"],
    "type": "CATALOG_UPDATE",
    "schema": "EMBER"
}

カタログの完全な置き換え

マニフェストでCATALOG_FULLを使用します。申請内容に存在しないアイテムはすべてシステムによって削除されます。この方法は注意して使用してください。

{
    "s3Bucket": "amazon-media-catalogs",
    "s3Keys": ["<プロバイダー>/prod/catalogs/full-catalog-20250501.xml.zst"],
    "type": "CATALOG_FULL",
    "schema": "EMBER"
}

特定のアイテムの削除

個々のアイテムを削除するには、インクリメンタル更新の中でDelete要素を使用します。

<ProgramCatalog id="MY_CATALOG" version="1">
    <Delete id="OLD_MOVIE" version="100"/>
    <Delete id="EXPIRED_SERIES" version="50"/>
</ProgramCatalog>

TV番組の階層を削除するときは、親よりも先に子を削除します。

<!-- 正しい順序で削除： エピソード→シーズン→シリーズ -->
<Delete id="SERIES_S01E01" version="10"/>
<Delete id="SERIES_S01" version="5"/>
<Delete id="SERIES_1" version="3"/>

自動化

信頼性の高い反復可能なアップロード方法を確立するには、カタログ申請プロセスを自動化します。AWS SDKとスケジュールジョブ（cron）を使用して、ロールの引き受け、認証情報の更新、カタログのアップロード、マニフェストの送信を処理します。

• 前へ - 手順4： Amazonからカタログの承認を受ける

Last updated: 2026年5月27日