ブック、ビデオ、ミュージック、アプリのコンテンツに対して、 iTunes Connect アカウント (ブックのパブリッシャパブリッシャーやミュージックのプロバイダ)、アカウント ( アプリデベロッパ)、 エンコーディングハウスアカウントのいずれかを使用している場合、Transporter を利用することで、ストアパッケージが Apple の各仕様を遵守しているか検証したり、Appleに正常にデリバリしたりすることができます。Transporter の一部オプションには、ユーザのタイプやコンテンツのタイプに応じた制限が設けられています。ストアパッケージをデリバリする前に、Transporter が認証するべきアカウント (iTunes Connect アカウント、App Store Connect アカウント、エンコーディングハウスアカウントのいずれか)を事前に確認してください。詳細については、「概要」を参照してください。

Transporter には以下の機能があります：

• 使いやすく、すぐに使用できるインストールパッケージ。macOS、Microsoft Windows、Red Hat Enterprise Linux 用のインストーラが含まれます。

• アセットの追跡。Transporter は、メタデータファイルで参照されるアセット (たとえば、カバーアート、オーディオファイル、ビデオファイル、アプリ内課金、Game Center) のリストを、実際にデリバリするファイルと照らし合わせて検証します。

  Transporter は、Web サービスを使用して、受信したメタデータとファイルのリストを照合して検証します。リストがメタデータの情報に一致しない場合、エラーメッセージが返されます。例：“Delivered file set does not contain expected file [34D17614CB805E8AB853CD5ABCBF3C0A-940AE112-01-18-mp4-128000.m4a] that is referenced in the metadata file”。

• 自動ソフトウェアアップデート。Transporter には独自の自動ソフトウェアアップデート機能が備わっています。Transporter が起動・実行され次第、ソフトウェアアップデート機能が Transporter のバージョンを自動的にチェックし、必要に応じてインストール内容をアップデートします。コンソール内にログ情報が表示されます。

• アセットのチェックサム検証。送信されるメタデータファイルに、デリバリする各ファイルのチェックサムを含める必要があります。Transporter は、このチェックサム 情報と Transporter が計算するチェックサム値を照合して、送信された各ファイルを検証します。

• エラー概要の出力。Transporter は、正常にアップロードできなかったストアパッケージに関するエラーの概要情報を表示します。Transporter はアップロードの試行の終了時に、正常に処理できなかったパッケージ名のリストに加え、エラーメッセージを含んだ概要テキストを表示します。例：

  Package Summary: 2 package(s) were not uploaded because they had problems: /Users/bsmith/Applications/Packages/Many/00000000001041.itmsp - Error Messages: Unable to find registered encoding house user for username "bsmith" (1001) /Users/bsmith/Applications/Packages/Many/00000000001042.itmsp - Error Messages: Unable to find registered encoding house user for username "bsmith" (1001)

• 進行状況インジケータの詳細情報。Transporter には、Transporter でのアップロード時に進行状況の詳細を表示するかどうかを指定できる、進行状況インジケータのオプションがあります。

• アップロードの再開。 アップロード中にネットワーク接続が失敗したり、サーバがオフラインになったりした場合でも、Transporter では後からアップロードを再開することができます。

このガイドは、次のように構成されています :

• 「新機能」には、最新リリースに含まれる拡張機能のリストが掲載されています。

• 「ようこそ」では、Transporter の概要と主要機能が紹介されています。

• 「はじめに」では、システムおよびネットワーク要件、Transporter をインストールして設定するステップがおおまかに説明されています。

• 「コンテンツタイプの詳細」には、各コンテンツタイプ (ブック、オーディオブック、ビデオ、App、ミュージック) 専用の機能とモードに関する参照資料を掲載しています。

• 「Transporter を実行する」では、Transporter の使用方法が説明されています。実行時に指定するあらゆるモード、オプション、値の説明も含まれています。

• 「Transporter の例」では、Transporter のオプションや値の使用方法について、詳細な例が紹介されています。

• 「Transporter のメッセージ」では、Transporter の使用中に表示されるエラーコードやメッセージが紹介されます。

• 「その他のリソース」では、このガイドで使用される用語を解説する用語集、このガイドで使用される表記法、コマンドライン help オプションの使用方法に関する情報、発生する可能性のある問題を診断し解決するトラブルシューティング情報などが提供されています。

加えて、参考情報として改定履歴が提供されています。

メモ：Apple ではソフトウェアのバージョンアップおよびアップデートを定期的に行うため、このガイドで示される画像や出力は実際の画面に表示される内容と若干異なる可能性があります。

• macOS 10.11 またはそれ以降 (64 ビットシステム)

• Microsoft Windows 11以降(64ビットシステム)

• Red Hat Enterprise Linux（64 ビットシステム）

Transporter をインストールして実行するには、次の要件を満たす必要があります：

• 150 メガバイト (MB) 以上の空きディスク容量とメモリ 2GB

• デフォルトの最大ヒープサイズ 2,048 MB

Transporter は SOA (Service Oriented Architecture) を使用してデータとメッセージを送受信します。Transporter は HTTPS プロトコルを使用して、Apple のオブジェクトストア (HTTP) サーバと通信します。この方法で問題がある場合は、Apple のテクニカル担当者にお問い合わせください。Signiant を利用する場合、Transporter は TCP/IP (Transmission Control Protocol/Internet Protocol) と UDP (User Datagram Protocol) を使用して、Signiant サーバと通信します。Aspera を利用する場合、Transporter は、TCP/IP と UDP の使用に加えて、SSH プロトコルを使用して Aspera サーバと通信します。

以下の表は、Transporterが通信するサーバに関する詳細を示しています。デフォルトでは、Transporterを使用するには、Appleのcontentdelivery.itunes.apple.comサーバと通信するポート443のみ必要です。デリバリ方法にAsperaを指定した場合のみ「Aspera専用」サーバを使用することができます。なお、その場合は追加の「Aspera専用」サーバを開く必要があります。Asperaサーバとの通信にはポート33001が必要です。また、デリバリ方法にSigniantを指定した場合のみ「Signiant専用」サーバを使用でき、その場合追加の「Signiant専用」サーバを開く必要があります。Signiantサーバとの通信にはポート44001が必要です。アウトバウンドとインバウンドのファイアウォールルールがある場合は、以下にリストされている該当ポートへの直接アウトバウンドおよびインバウンド接続を開く必要があります。

Aspera または Signiant を使用した方法でデリバリする場合は、追加のセットアップとコンフィグレーションを実施する必要があります。詳細については、Upload モードを使用するの Aspera および Signiant の例を参照してください。

• Apple Books にコンテンツをデリバリする前に認証プロセスを完了すること。

• 受け入れ可能なブックフォーマットまたは受け入れ可能なオーディオブックフォーマットでのみデリバリすること。

• 常に最新バージョンの Transporter、Apple Books ブックパッケージ仕様書、Apple Books アセットガイド、およびオーディオブック仕様書 を使用すること。

• Transporter のデリバリログを保存すること (eXtreme の詳細レベルを使用)。デリバリの際のサポートを Apple に依頼する場合、ログの提出が必要となります。

Transporter の実行にあたっては、さまざまなモード、オプション、値を使用できます。ただし、パブリッシャに全モードが適用されるわけではありません。下表を参考にして、ブックのコンテンツに最適のモードを把握してください。

• ビデオコンテンツをデリバリする前に、資格審査を通り、エンコーディングハウスアカウントが発行されていること。

• 受け入れ可能な映画フォーマットのみデリバリすること。「Appleビデオとオーディオのアセットガイド」の「映画コンテンツのプロファイル」の章と、「Appleビデオとオーディオのアセットガイド」の「テレビ番組のコンテンツのプロファイル」の章を参照してください。

• 常に最新バージョンの Transporter、Apple EST／VOD 映画仕様 、Apple EST／VOD TV仕様、および Apple ビデオとオーディオのアセットガイドの最新バージョンを使用すること。

• Transporter のデリバリログを保存すること (eXtreme の詳細レベルを使用)。デリバリの際のサポートを Apple に依頼する場合、ログの提出が必要となります。

Transporter の実行にあたっては、さまざまなモード、オプション、値を使用できます。ただし、ビデオのエンコーディングハウスに全モードが適用されるわけではありません。下表を参考にして、ビデオのコンテンツに最適のモードを把握してください。

• ミュージックコンテンツをデリバリする前に、資格審査を通り、エンコーディングハウスアカウントが発行されていること。

• 受け入れ可能なミュージックフォーマットのみデリバリすること。「Appleビデオとオーディオのアセットガイド」の「ミュージックオーディオコンテンツのプロファイル」を参照してください。

• 常に最新バージョンの Transporter、Apple Music仕様、Apple ビデオとオーディオのアセットガイドを使用すること。

• Transporter のデリバリログを保存すること (eXtreme の詳細レベルを使用)。デリバリの際のサポートを Apple に依頼する場合、ログの提出が必要となります。

Transporter の実行にあたっては、さまざまなモード、オプション、値を使用できます。ただし、ミュージックパートナーに全モードが適用されるわけではありません。下表を参考にして、ミュージックのコンテンツに最適のモードを把握してください。

Transporterを使用するアプリデベロッパには、以下が義務づけられています。

• iOS、tvOS、visionOS アプリ向けの IPA ファイル (.ipa) または macOS アプリ向けの PKG パッケージファイル (.pkg) をデリバリします。

• 常に最新バージョンの Transporter を使用すること。

• Transporter を手動でダウンロードし、インストールすること。詳細については、以下の「アプリデベロッパのインストール」を参照してください。

• Transporter のデリバリログを保存すること (eXtreme の詳細レベルを使用)。デリバリの際のサポートを Apple に依頼する場合、ログの提出が必要となります。

Transporter にサインインするとき使用する Apple アカウントに、複数の App Store Connect プロバイダが関連付けられている場合、-asc_provider を使用して、現在のセッションに使用するプロバイダを指定する必要があります。Provider モードを使用すると、デリバリの権限を持つプロバイダアカウントのリストを取得できます。

Transporterの実行にあたっては、さまざまなモード、オプション、値を使用できます。ただし、アプリデベロッパに全モードが適用されるわけではありません。下表を参考にして、アプリのコンテンツに最適のモードを把握してください。

使用情報のみを取得するには、コマンドラインオプションを指定せずに Transporter を実行します。 たとえば、次のように入力します：

詳細については、コマンドラインヘルプを参照してください。

Asset Pack Statusモードは、macOSのほか、LinuxとWindowsでもサポートされています。このモードには、以下の2つのフォーマットがあります。

• フォーマット1：アセットパックのバージョンIDを指定します。

• フォーマット2：アプリケーションのApple IDとアセットパックのデベロッパIDを指定します。

フォーマット1：以下のコマンドラインオプションを指定する必要があります。

• -m assetPackStatus

• -assetPackVersionId<id>

• -u<username>

• -p<password>

• -asc_provider <shortname> (ユーザ名とパスワードの認証に必須)

フォーマット2：以下のコマンドラインオプションを指定する必要があります。

• -m assetPackStatus

• -apple_id<id> (アプリケーションのApple ID)

• -assetPackId <id> (このアセットパックのデベロッパID。LinuxとWindowsでのアップロードには-assetPackIdが必須です)

• -version <string> (このアセットパックのバージョン文字列)

• -u<username>

• -p<password>

• -asc_provider <shortname> (ユーザ名とパスワードの認証に必須)

例：フォーマット1

例：フォーマット2

Create Artist モードでは、以下のコマンドラインオプションを指定する必要があります：

• -m createArtist

• -u<username>

• -p<password>

• -n<searchterm>

• -nativeLocale<nativelocalecode>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-nameForSorting<sortingname>]

• [-forceCreateToken<forcecreationtoken>]

• [-s<shortname>]

• [-itc_provider<shortname>]

• [-o<output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

• [-outputFormat xml]

• [-escapeXML <true | false>]

次の例では競合するアーティストがないため、Transporter がコマンドの実行を終了するとアーティスト「Jonny Doe」が作成されたことを示す情報を返します。

Transporter 出力情報やログ情報などのより詳細な例については、Create Artist モードを参照してください。

Create Tickets モードを使用するには、iTunes Connect アカウントが必要です。Create Tickets モードで、エンコーディングハウスのユーザ名とパスワードを使うことはできません。

Create Ticketsモードでは、以下のコマンドラインオプションを指定してください：

• -m createMetadataTicket

• -u<username>

• -p<password>

• -vendor_id <identifier> または -apple_id <identifier>

• -note<text>

• [-itc_provider<shortname>]

• [-v <off | informational | critical | detailed | eXtreme>]

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-playlistGenre<newcode>]

• [-playlistTitle<newtitle>]

• [-playlistTitleTranslation<lang>:<translation>]

• [-trackTitle <newtitle>] *

• [-trackTitleTranslation [<disc_number:>]<track_number>:<lang>:<translation>]

• [-titleVersion<newtitle>]

• [-trackTitleVersion<newtitle>]

• [-o<output>]

ユーザがアプリデベロッパの場合は、Create Ticketsモードを使用できません。

以下の例では、Transporter はコマンドの実行を完了すると、eXtreme ログ情報を標準エラー出力に返し、プレイリストタイトルを変更するメタデータチケットが正常に作成されたかどうかに関する情報を返します。

Transporter 出力情報やログ情報などのより詳細な例については、Create Ticketsモードを参照してください。

Diagnostic モードで実行すると、指定した値 -t <transport> に基づき、Transporter が Web サービスやさまざまなホストおよびポートのテストを行います。転送オプションと値 (HTTP、Aspera、Signiant) を指定することで、正しい診断を実行します。複数の値を指定すると (例：-t HTTP,Aspera,Signiant)、Transporter は Web サービスと、指定された各転送モードのサーバのステータスと可用性をチェックします。

転送オプションと値を指定しない場合、Transporter は自動転送検出を使用して、パッケージに最適な転送モードを判別します。現在、Transporter では、最適な転送モードとしてデフォルトで HTTP が指定されます。エラーまたはサーバが使用不能であるために、指定された転送を使用できない場合、Transporter は転送の優先順位に基づいて別の転送を選択します。選択可能な転送オプションがなくなるまで、Transporter は次々と代替の転送モードを選択します。選択可能な転送オプションがなくなった時点で、デリバリが失敗します。カンマ (,) で区切って任意の順序でデリバリ方法を指定することによって、デフォルトの順序をオーバーライドできます。例：-t HTTP,Aspera,Signiant。転送オプションを 1 つのみ指定している場合 (-t Aspera)、Transporter はそのオプションを使用します。そのオプションが診断チェックに失敗した場合、ほかのオプションは選択されずにデリバリは失敗します。

ユーザ名やパスワードを指定しない場合、Transporter は基本診断テスト (たとえば、TCP 接続テスト) を行います。ユーザ名とパスワードを指定した場合、Transporter は拡張診断テストを実行します (たとえば、Transporter は Signiant サーバと Aspera サーバへの TCP および UDP 接続に関してより正確なテストを実行できます)。

すべての転送診断が失敗した場合、Transporter は概要情報に失敗の理由をログ記録します。

Diagnosticモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m diagnostic

• -t<transport>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-u<username>]

• [-p<password>]

• [-o<output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

以下の例では、Transporter がコマンドの実行を完了したときに、eXtreme ログ情報をコンソールに返すと同時に、Web サービスに関する情報、そしてコンピュータと Aspera サーバ間のネットワーク接続に問題がある場合は、その問題に関する情報を返します。

Transporter 出力情報やログ情報などのより詳細な例については、次をセクションを参照してください。

• Transporter の一部コンポーネントにセキュリティの脆弱性が発見された場合

• Transporter を使用するにあたり、Java 仮想マシンのバージョンアップデートが必要な場合

• Transporter の最新バージョンへの自動アップデートが行われない Docker イメージで Transporter を実行している場合

• 新しいマシンへの Transporter のダウンロードを簡単に行う場合

デフォルトでは、Download Installer モードを使用すると、現在使用しているオペレーティングシステムおよびマシンアーキテクチャ向けの Transporter のインストーラが、現在指定されているディレクトリにダウンロードされます。オペレーティングシステムやマシンアーキテクチャ、ダウンロード先のディレクトリの変更は、コマンドラインオプションを使用して行えます。

またこのモードでは、ダウンロードされるインストーラのバージョンに応じて、専用のインストール手順が表示されます。

Download Installer モードでは、以下のコマンドラインオプションを指定してください。

• -m downloadInstaller

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-arch <x86_64 | arm64 | aarch64>]

  インストーラに対してマシンのアーキテクチャを指定します。有効な値は、x86_64、arm64、aarch64 です。

  このオプションを省略した場合、コマンドではデフォルトで現在のマシンのアーキテクチャが使用されます。

• [-destination<path>]

  インストーラのダウンロード先となるディレクトリを指定します。

  このオプションを省略した場合、コマンドではデフォルトで現在指定されているディレクトリが使用されます。

• [-os <macOS | Linux | Windows>]

  インストーラに対してオペレーティングシステムを指定します。有効な値は、macOS、Linux、Windows です。

  このオプションを省略した場合、コマンドではデフォルトで現在のマシンのオペレーティングシステムが使用されます。

公開識別子は、以下のサンプル JSON 出力に示されている "id" フィールドです。アセットの配列内の日付は、ISO-8601 オフセット日時形式 YYYY-MM-DDThh:mm:ssTZD (2023-04-23T04:55:36-07:00 など) を使用します。

Get Asset List モードでは、以下のコマンドラインオプションを指定する必要があります。

• -m getAssetList

• -u<username>

• -p<password>

• -s <shortname> | -itc_provider<shortname>

  -s を使用してエンコーディングハウスプロバイダのショートネームを指定するか、-itc_provider を使用して iTunes Connect プロバイダのショートネームを指定します。

• -assetType"audiobook"

  サポートされているアセットタイプは "audiobook" のみです。

• -startDate <date> | <timestamp>

  次のいずれかを指定してください。

  • 開始日 <date> (ISO-8601 形式 YYYY-MM-DD を使用)。日付を指定すると、プロバイダのタイムゾーンを使用して日付がオフセット付きの日付タイムスタンプに変換され、時刻は 00:00:00 に設定されます。「オプションと値を指定する」の -startDate オプションに関する情報を参照してください。

  • 開始タイムスタンプ <timestamp> (ISO-8601 形式 YYYY-MM-DDThh:mm:ssTZD、ISO_ZONED_DATE_TIME 形式を使用)。開始タイムスタンプを指定することで、重複を処理しないようにします。

以下のコマンドラインオプションは、任意で指定することができます。

• [-endDate <date> | <timestamp>]

  次のいずれかを指定してください。

  • 終了日 <date> (ISO-8601 形式 YYYY-MM-DD を使用)。日付を指定すると、プロバイダのタイムゾーンを使用して日付がオフセット付きの日付タイムスタンプに変換され、時刻は 23:59:59 に設定されます。「オプションと値を指定する」の -endDate オプションに関する情報を参照してください。

  • 終了タイムスタンプ <timestamp> (ISO-8601 形式 YYYY-MM-DDThh:mm:ssTZD、ISO_ZONED_DATE_TIME 形式を使用)。

  -endDate オプションを指定しない場合、指定した開始日以降に変更されたすべてのアセットファイルが配列に含まれます。

• [-jsonFile]<output>

  指定した場合、JSON 形式の配列が出力ファイルに書き込まれます。ファイルがすでに存在する場合は、上書きされます。

  指定しない場合、JSON 形式の配列は標準出力に書き込まれます。

• [-v <off | informational | critical | detailed | eXtreme>]

• [-WONoPause <true | false>]

注

• スケジュールに従ってアセットを定期的にダウンロードする場合は、直近でダウンロードしたアセットの lastUpdatedDate の日付で最後のものを控えておいてください。その日付を次のダウンロードの開始日として使用します。

• 暗号処理のオーバーヘッドにより、JSON 形式のアセット配列で指定されたファイルサイズは、実際のファイルサイズと異なる場合があります。ファイルの更新を確認するためにファイルサイズを参照すると正しい判断ができないため、代わりに lastUpdatedDate 値を使用してください。

サンプル JSON 出力

List Asset Packsモードでは、以下のコマンドラインオプションを指定する必要があります。

• -m listAssetPacks

• -apple_id<id> (アプリケーションのApple ID)

• -u<username>

• -p<password>

• -asc_provider <shortname> (ユーザ名とパスワードの認証に必須)

例

List Asset Pack Versionsモードでは、以下のコマンドラインオプションを指定する必要があります。

• -m listAssetPackVersions

• -apple_id<id> (アプリケーションのApple ID)

• -assetPackId <id> (このアセットパックのデベロッパID。LinuxとWindowsでのアップロードには-assetPackIdが必須です)

• -u<username>

• -p<password>

• -asc_provider <shortname> (ユーザ名とパスワードの認証に必須)

例

List Reportsモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m listReports

• -u<username>

• -p<password>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-o<output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-WONoPause <true | false>]

• [-outputFormat xml]

以下の例では、Transporter はコマンドの実行を完了すると、eXtreme ログ情報を標準エラー出力に返し、プロバイダの過去 30 日間のすべてのカタログレポートのリストを返します。

Transporter 出力情報やログ情報などのより詳細な例については、List Reportsモードを参照してください。

List Report Types モードでは、以下のコマンドラインオプションを指定する必要があります：

• -m listReportTypes

• -u<username>

• -p<password>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-o <output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-WONoPause <true | false>]

• [-outputFormat xml]

以下の例では、Transporter はコマンドの実行を完了すると、eXtreme ログ情報を標準エラー出力に返し、プロバイダが入手できるレポートタイプのリストを返します。

Transporter 出力情報やログ情報などのより詳細な例については、テレビ番組プロバイダのレポートの種類、App デベロッパのレポートの種類を参照してください。

• 名前、Apple ID、プライマリジャンル、ロケール、作成日

• タイトル (ミュージックアーティストのリリースされた最新のアルバムまたは曲を 5 つまで、または映画アーティストのリリースされた最新の映画を 5 つまで)

• タイトルの Apple ID とコンテンツプロバイダ

• アーティスト名のローカリゼーション、役割、および Store URL (XML 出力でのみ表示)

• キュレーションされたステータス (ミュージックアーティストおよびブックの著者向け)

Lookup Artistモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m lookupArtist

• -u<username>

• -p<password>

• -n <searchterm> または -apple_id <identifier>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-searchLocale<localecode>]

• [-artistType<Music | Movie | Author>]

• [-outputFormat xml]

• [-escapeXML <true | false>]

• [-s<shortname>]

• [-itc_provider<shortname>]

• [-o<output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

以下の例では、Transporter はコマンドの実行を完了したときに、指定された検索条件に一致するアーティストに関連する名前、ジャンル、Apple ID、および言語を示す情報をコンソールに返します。Transporter は出力情報をXMLフォーマットで返します。

Transporter 出力情報やログ情報などのより詳細な例については、Lookup Artistモード、ミュージックアーティスト向けの Lookup Artist モード (XML 形式の出力結果を表示)、映画アーティスト用の Lookup Artist モード、ブックの著者用の Lookup Artist モードを参照してください。

Lookup Metadata モードを使用して、ベンダー ID (-vendor_id) と Apple ID (-apple_id) のどちらかでメタデータを検索するかを指定すると、Transporter は Web サービスにメッセージを送信し、指定したディレクトリ内にあるメタデータのスタブパッケージを生成します。また、複数のベンダー ID (-vendor_ids) または Apple ID (-apple_id) をカンマ区切りリストで指定することで、複数のパッケージを同時に検索することもできます。

Transporter が現在のメタデータを取得した後に作成する「<identifier_option_value>.itmsp」または「<app_SKU>.itmsp」という名前のスタブパッケージは、metadata.xml ファイル１つで構成され、Web サービスにより Transporter に渡された XML メタデータが格納されています。Transporter は -destination で指定されたディレクトリにこのスタブパッケージを保管します。

Transporter は、メタデータにある以下の情報も（あれば）返します：

• アートワークファイル名の情報。Transporter は次のようなメッセージで、パッケージを再度アップロードする前に、必要に応じてアートワークファイル名とチェックサムファイル名を差し替えるよう促します：「<!--NOTE: The file name 010058208723.jpg and its checksum may need to be changed to reflect their original values. Alternately, you may decide to remove this <album_artwork_files> block altogether to achieve a successful metadata-only upload.—>」。

• 品質管理エンコード情報。Transporter は次のような内容のメッセージで、アセットの品質管理エンコードへの URL を提供し、パッケージを再度アップロードする前に問題がある場合、元のソースと比較し修正できるようにします：「<!--A quality control encode of this video was created. It may be downloaded at the following url: https://sample.apple.com/us/r10/Video/41/bd/1f/mzm.dijmlsrs.mov?downloadKey3=1243559291_23bae98151c8fe0dbfc054618993e0b5. Please note that the url will be available for 180 minutes.-->」。有効期限が切れた URL にアクセスする必要がある場合は、Transporter をもう一度 Lookup Metadata モードで実行して、新しい URL を取得してください。

• スクラッチエンコード情報。Transporter は次のような内容のメッセージで、アセットのスクラッチエンコードへの URL を提供し、パッケージを再度アップロードする前にアセットの同期を確認できます：「<!--A scratch encode of this video was created. It may be downloaded at the following url: https://sample.apple.com/us/r10/Video/41/bd/1f/mzm.dijmlsrs.mov?downloadKey3=1243559291_23bae98151c8fe0dbfc054618993e0b5. Please note that the url will be available for 180 minutes.-->」。有効期限が切れた URL にアクセスする必要がある場合は、Transporter をもう一度 Lookup Metadata モードで実行して、新しい URL を取得してください。

• メタデータトークン情報。Transporterは<package>要素の直後に<metadata_token>要素を含めます。これは、以前アップロードしたプレイリストの現在のメタデータを取得するために、前回Lookup Metadataモードを使用したのがいつかをAppleが判断するのに役立ちます。例：

  <package xmlns="http://apple.com/itunes/importer/publication" version="publication5.0"> <metadata_token>1405704088101-ae534236053dbb0b082dd6319857a403bce91396e5753fa6ff70f8b3047609fc</metadata_token>

  <metadata_token> 要素の情報は編集しないでください。

メモ：アセット（たとえば、アートワークファイル、オーディオファイル、ビデオファイル、EPUBファイルなど）のファイル名、サイズ、またはチェックサムを変更する場合は、更新後のファイル名、サイズ、チェックサムと一致する新しいアセットファイルを提供する必要があります。

Lookup Metadataモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m lookupMetadata

• -u<username>

• -p<password>

• -destination<path>

• -vendor_id <identifier> | -vendor_ids <”identifier,identifier,identifier”> | -apple_id <identifier> | -apple_ids <”identifier,identifier,identifier”>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-s<shortname>]

• [-itc_provider<shortname>]

• [-o<output>]

• [-outputType <metadata_only | asset_only | metadata_plus_assets>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

• [-subitemtype <None | GameCenterLeaderboard |GameCenterAchievement>] または [-subitemids]

• [-umc_catalog_id <identifier>]

• [-umc_content_id <identifier>]

• [-umc_variant_id <identifier>]

以下の例では、Transporter がコマンドの実行を完了したときに、eXtreme ログ情報を標準エラーに返します。また、4463953 プレイリストの現在のメタデータを格納したスタブパッケージを作成し、それを /tmp/packages ディレクトリに保存します。

-subitemtype と -subitemids を使用して、サブアイテムを検索します。たとえば、次のメタデータを検索できます：

• 2 つの特定の Game Center Leaderboard： -subitemtype GameCenterLeaderboard -subitemids com.mycompany.Leaderboard01,com.mycompany.Leaderboard02

• 2 つの特定の Game Center 達成項目： -subitemtype GameCenterAchievement -subitemids com.mycompany.Achievement01,com.mycompany.Achievement02

サブスクリプションビデオのメタデータを検索するには、UMC のカタログ ID (-umc_catalog_id)、コンテンツ ID (-umc_content_id)、バリアント ID (-umc_variant_id) を指定します。

• -umc_catalog_id オプションでは、カタログ ID を指定します。この値は複数回指定することが可能です。1 回のみ指定した場合は、指定した値がすべてのコンテンツ ID およびバリアント ID に適用されます。複数回指定する場合は、指定する回数をコンテンツ ID およびバリアント ID を指定した回数にそろえる必要があります。

• -umc_content_id オプションでは、コンテンツ ID を指定します。この値を複数回指定する場合、指定する回数をバリアント ID を指定した回数にそろえる必要があります。

• -umc_variant_id オプションでは、バリアント ID を指定します。この値を複数回指定する場合、指定する回数をコンテンツ ID を指定した回数にそろえる必要があります。

次の例では、1 つのサブスクリプションビデオが指定されています。

次の例では、複数のサブスクリプションビデオが指定されています。

Transporter 出力情報やログ情報などのより詳細な例については、Lookup Metadata モード (単一のストアパッケージ)、Lookup Metadata モード (複数のストアパッケージ)を参照してください。

Providerモードで、以下のコマンドラインオプションを指定しなければなりません：

• -m provider

• -u<username>

• -p<password>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-account_type <encoding_house | itunes_connect>]

• [-o<output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

以下の例では、Transporter はコマンドの実行を完了したときに、eXtreme ログ情報と、あなたがコンテンツをデリバリすることを許可しているプロバイダのリストをコンソールに返します：

Transporter 出力情報やログ情報などのより詳細な例については、Providerモードを参照してください。

Query Ticketsモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m queryTickets

• -u<username>

• -p<password>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-s<shortname>]

• [-itc_provider<shortname>]

• [-o<output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-vendor_id<identifier>] または [-apple_id<identifier>]

返されるチケットの数を制限するには、-vendor_id または -apple_id を指定します。この場合、Transporter は、指定された ID と関連付けられているチケットだけを返します。

メモ：エンコーディングハウスのユーザは、Apple の事前承認なしでこのモードを使用しないでください。詳細については、Apple のテクニカルレーベル担当者にお問い合わせください。

次の例で Transporter は、コマンドの実行を完了したときに、注意が必要なすべての未対応チケットに関する情報とともに eXtreme ログ情報を標準エラーに返します。Transporter は出力情報を XML フォーマットで返します。

Transporter 出力情報やログ情報などのより詳細な例については、Query Ticketsモードを参照してください。

Repair Assets モードでは、既存のストアパッケージは変更されません。Repair Assets モードを使用してアセットファイルを修復した後は、ストアパッケージに含まれる未修復のアセットファイルを修復済みの新しいアセットファイルに置き換えて、XML メタデータファイル (metadata.xml)を適切にアップデートする必要があります。

Apple では現在、EPUB ファイル（.epub）の修復のみをサポートしています。

Repair Assetsモードを使用する場合は、以下の点に注意してください：

• -assetFile オプションには、適切なファイル拡張子 (.epub) を持つファイルを設定してください。

• -assetFolder ディレクトリと -destination ディレクトリを同一にすることはできません。

• -assetFile 親ディレクトリと -destination ディレクトリを同一にすることはできません。

• --assetFolder を使用すると、Transporter は指定されたディレクトリ内のファイルのうち、該当するファイル拡張子 (.epub) を持つファイルのみを修復します。

• Transporter は、修復したファイルを、元のファイルと同じファイル名で宛先ディレクトリに保存します。

Repair Assetsモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m repairEpubAssets

• -assetFolder <path> または -assetFile <path>

• -destination<path>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-o<output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-removeUnmanifestedFiles]

このモードは、ユーザがパブリッシャーの場合にのみ有効です。アプリデベロッパの場合は、Repair Assetsモードを使用できません。

次の例では、Transporter がコマンドの実行を完了すると、/tmp/epub ディレクトリ内のどのファイルが修復され、保存先ディレクトリ (/tmp/epub/repair/) に保存されたのかに加え、修復されたファイルのチェックサム情報と eXtreme ログ情報が表示されます。

Transporter 出力情報やログ情報などのより詳細な例については、Repair Assetsモードを参照してください。

過去 24 時間以内のレポートをリクエストした場合、そのレポートがダウンロード可能であれば、Transporter は即時にレポートを指定されたディレクトリにダウンロードします。過去 24 時間以内のレポートをリクエストして、そのレポートのダウンロードが可能でない場合、Transporter はダウンロードができないことを示すステータスメッセージを表示します。過去 24 時間以内にレポートをリクエストしていない場合、Transporter は新規レポートのリクエストを作成します。

Request Reportモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m requestReport

• -u<username>

• -p<password>

• -destination<path>

• -type<type>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-reportDate<date>]

• [-o<output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-WONoPause <true | false>]

• [-outputFormat xml]

以下の例では、Transporter はコマンドの実行を完了すると、eXtreme ログ情報を標準エラー出力に返すと同時に、プロバイダの過去 30 日間のの全カタログレポートを返します。 レポートが利用可能な場合、Transporter は /tmp/RequestReport/ ディレクトリにレポートを保存します。

Transporter 出力情報やログ情報などのより詳細な例については、Request Reportモードを参照してください。

このモードを使うことで、各アセットファイルと関連メタデータを出力ディレクトリにダウンロードできます。詳しくは -destination オプションのセクションをご覧ください。

注：オーバーヘッドを含め、リクエストした全ファイルの書き込み処理に必要なディスク容量が、ターゲットディレクトリを操作するファイルシステムにあるかについては、Transporter で確認が行われます。このオーバーヘッドに必要な容量は、全ファイルの中で最大のものをダウンロードする際に必要な容量と等しくなります。アセットは暗号化ファイルとして書き込まれた後、まとめて復号化されます。復号化されたファイルが書き込まれたのち、暗号化ファイルは削除されます。

Retrieve Asset モードでは、以下のコマンドラインオプションを指定する必要があります。

• -m retrieveAsset

• -u<username>

• -p<password>

• -s <shortname> または -itc_provider <shortname>

  -s を使用してエンコーディングハウスプロバイダのショートネームを指定するか、-itc_provider を使用して iTunes Connect プロバイダのショートネームを指定します。

• -assetType"audiobook"

  サポートされているアセットタイプは "audiobook" のみです。

• -vendor_id <identifier>、-vendor_ids<”identifier,identifier,identifier”>、-vendor_id_file<path> のいずれか

  -vendor_id は、コンテンツプロバイダのベンダー ID を 1 つ定義する際に使用します。

  -vendor_ids は、コンテンツプロバイダのベンダー ID を複数定義する際に使用します。各 ID の間はカンマで区切り、全体を引用符で囲んでください。

  -vendor_id_file は、各行にベンダー ID が 1 つずつ記述された、ベンダー ID リストのファイルを定義する際に使用します。

• -public_id <identifier>、-public_ids<”identifier,identifier,identifier”>、-public_id_file<path> のいずれか

  -public_id は、コンテンツプロバイダの公開識別子を 1 つ定義する際に使用します。

  -public_ids は、コンテンツプロバイダの公開識別子を複数定義する際に使用します。各 ID の間はカンマで区切り、全体を引用符で囲んでください。

  -public_id_file は、各行に公開識別子が 1 つずつ記述された、公開識別子リストのファイルを定義する際に使用します。

  注

  •  Get Asset List モードで取得した JSON 形式のリストには、"id" 値が記述されています。この "id" 値は、Retrieve Asset モードのコマンド内で <identifier> として使用できます。

  • ベンダー ID より公開識別子を使用する方が、効率的に実行できます。公開識別子を使用することで、間に発生する Web サービスコールの数を減らすことができます。

• -destination<path>

  <path> では、ダウンロードするアセットの最上位ディレクトリを指定します。完全パスは次の形式で記述します。

  フォルダ：<path>/<identifier>.<asset-type><identifier> にはベンダー ID を記述してください。

  • 例：<path>/9781728280660.audiobook/

  メタデータ：<path>/<identifier>.<asset-type>/metadata.json<identifier> にはベンダー ID を記述してください。

  • 例：<path>/9781728280660.audiobook/metadata.json

  アセット：<path>/<identifier>.<asset-type>/<asset-file>.<ext><identifier> にはベンダー ID を記述してください。

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-includeCoverArt]

  -includeCoverArt が定義されていない場合、カバーアートはダウンロードされません。

• [-v <off | informational | critical | detailed | eXtreme>]

• [-WONoPause <true | false>]

Apple では、XML メタデータを送信する前に、ファイルに構造上のエラーやフォーマット上のエラーがないことを確認するよう推奨しています。エラーを含むファイルは拒否され、コンテンツのデリバリに遅延が発生する可能性があります。コンテンツのデリバリに使用されるスキーマ言語は Relax NG (RNG) です。したがって、エラーの確認には RNG スキーマを検証できるツールが必要となります。

メモ：スキーマファイルは動的であり、1つのファイルにスキーマタイプが混合（たとえば、musicとtvなど）されていることがよくあります。

Schemaモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m generateSchema

• -u<username>

• -p<password>

• -schema<typeversion> | “jp-itt-v2"

• -schemaType <transitional | strict>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-s<shortname>]

• [-itc_provider<shortname>]

• [-o<output>]

• [-destination<path>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

以下の例では、Transporter はコマンドの実行を完了したときに、eXtreme ログ情報をコンソールに返します。 また、Store Package 映画仕様バージョン 4.7 の暫定スキーマファイルもコンソールに返します。

Transporter 出力情報やログ情報などのより詳細な例については、Schemaモードを参照してください。

Speed Checkを実行してアップロード転送のパフォーマンスを測定する場合、Transporterは、指定されたサイズのランダムなバイナリファイルを作成し、Appleのサーバにアップロードします。特定の転送プロトコルを指定した場合を除き、Appleがサポートする各転送プロトコルでテストが実施されます。

デフォルト設定を使用して、すべての転送プロトコルでテストを実施することを推奨します。すべてのプロトコルでSpeed Checkを実行することで、結果を比較できます。

Speed Checkが正常に完了すると、Transporterは各アップロードの結果として、スループットと合計伝送時間のレポートを表示します。アップロードが失敗した場合、Transporterは失敗の内容を説明する通知メッセージ、警告メッセージ、またはエラーメッセージを返します。Transporterは、ログに記録される概要に加えて出力ファイルを生成します。このファイルを、Appleに送信し、アップロード速度に関する問題の診断サポートを依頼することができます。

出力ファイルは、SpeedCheck-<YYYY-MM-DD-HH-mm-ss>.zipという名前で生成されます。<YYYY-MM-DD-HH-mm-ss>は、Speed Checkが実行されたときのタイムスタンプです。このファイルの名前は、コンソールログ出力内の概要レポートの後に表示されます。このZIPファイルには以下が含まれます。

• オペレーティングシステムごとのフォルダ：実行された各コマンドのファイルまたはフォルダが含まれます。出力には、アップロードに使用されたネットワークインターフェイスが記述されます。

• network-interfaces.jsonファイル：ネットワークインターフェイスに関する情報。

• networkQualityフォルダ：networkQualityプログラムの出力。この情報は、テストファイルの最適なサイズを判断するのに役立ちます。

• speed-check-info.jsonファイル：Transporterを開始した方法に関する情報。この情報は、サーバ側の問題の調査に役立ちます。

• speed-checks.jsonファイル：各転送タイプの統計情報。

• tracerouteフォルダ：tracerouteコマンドの出力。この情報は、ネットワークトラフィックがどこでパブリックネットワークを使用し、どこからAppleの内部ネットワークに入っているかを調査するのに役立ちます。

• transport-log.txtファイル：Speed Checkの実行中に生成されたTransporterコンソール出力のコピー。

このモードは、パッケージのアップロードプロセス全体ではなく、ファイルのアップロードに着目しているという点で「Transfer Testモードを使用する」とは異なります。

Speed Checkモードでは、以下のコマンドラインオプションを指定する必要があります。

• -m speedCheck

• -u<username>

• -p<password>

• -k<kilobits_per_second>

また、以下のいずれかのオプションを指定する必要があります。

• [-asc_provider<WWDR_team_ID>]

• [-itc_provider<shortname>]

• [-s<shortname>]

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-f<file>] *

• [-itc_provider<shortname>]

• [-o<output>]

• [-errorLogs<path>]

• [-t<transport>]

• [-size<value>] **

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-indicator <true | false>]

• [-WONoPause <true | false>]

• [-outputFormat xml]

例

次の例では、Transporterがコマンドの実行を完了すると、eXtremeログ情報と、1ギガバイトのテストファイルの合計伝送時間とその他の詳細を「Speed Check Summary」で返します。「Speed Check Summary」には、次の情報が記載されます。

• 各転送プロトコルでアップロードされたテストファイルの名前。

• アップロードされたファイルのサイズ。

• 検出されたネットワークインターフェイス。

• 各転送プロトコルでの転送に関する統計情報。この結果は、転送速度が最も速いものから順に記載されます。

出力例

Status モードを使用することで、パッケージの状態と、パッケージにエラー (内部転送エラーや読み込みエラーなど) があるかどうかを確認できます。またパッケージのベンダー ID または Apple ID、コンテンツステータス情報 (Live、Other、Not Live、In Review など) や、コンテンツのレビュー状態 (たとえば、NotLive-WaitingForReview) を知ることができます。さらに、すべてのコンテンツタイプ (ミュージック、テレビ、ブック、アプリケーションなど) について、Transporter は以下の情報を表示します：

• 「Upload state」および「Upload state id」フィールドでは、パッケージが Internal Transfer、Uploading、Ready to Import、Importing、Import Error、Imported、または Not to be Processed のどの状態であるかを示します。

• 「Content state」および「Content state id」フィールドは、iTunes Connect におけるパッケージの状態が Polished (レビュー完了) か Unpolished (レビュー未完了) かを示します。

• 「On Store」、「Ready For Store」、「Not On Store」フィールドは、パッケージの状態を国または地域別に示します。各ステータスについて、Transporter はカンマで区切られた国／地域コードのリストまたは「N/A」を表示します。「N/A」は、そのステータスに該当する国や地域はないという意味です。このステータス情報は、アプリケーションや着信音では使用することができません。

• 「Upload created」は、Transporter がパッケージをアップロードした日時を示します。

Apple へのパッケージのアップロードが正常に完了していても、Apple のサーバ側で処理が正常に終わっていない場合もあります。 Statusモードのオプションで、パッケージが Apple でどのように処理されているか確認することができます。

映画やテレビのコンポーネントを含むパッケージのステータス情報をリクエストする場合には、Statusモードはパッケージのステータスとコンポーネントのステータス情報の両方を返します。 コンポーネントのステータス情報は映画やテレビにのみ適用されます。 たとえば、ビデオ、オーディオ、サブタイトルなどの各コンポーネントに関して、Transporter はコンポーネントのタイプ別にラベル付けされた次の情報を返します：

コンポーネントが却下された場合、却下理由に関する説明が返されます。次に例を示します。

アプリケーションまたは着信音が含まれるパッケージのステータス情報をリクエストした場合、Status モードではアップロードとコンテンツの情報だけが返されます。Status モードは、アプリケーションと着信音のステータス (On Store、Ready For Store、Not On Store) はサポートしません。

Statusモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m status または -m statusAll

• -u<username>

• -p<password>

• -vendor_id <identifier> | -vendor_ids <”identifier,identifier,identifier”> | -apple_id <identifier> | -apple_ids <”identifier,identifier,identifier”>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-s<shortname>]

• [-itc_provider<shortname>]

• [-o<output>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

• [-outputFormat xml]

• [-umc_catalog_id <identifier>]

• [-umc_content_id <identifier>]

• [-umc_variant_id <identifier>]

以下の例では、Transporter はコマンドの実行を完了したときに、eXtreme ログ情報をコンソールに返し、ベンダー（00028947576600）がアップロードした直近のパッケージのステータス情報を返します。

サブスクリプションビデオのステータス情報を取得するには、UMC のカタログ ID (-umc_catalog_id)、コンテンツ ID (-umc_content_id)、バリアント ID (-umc_variant_id) を指定します。

• -umc_catalog_id オプションでは、カタログ ID を指定します。この値は複数回指定することが可能です。1 回のみ指定した場合は、指定した値がすべてのコンテンツ ID およびバリアント ID に適用されます。複数回指定する場合は、指定する回数をコンテンツ ID およびバリアント ID を指定した回数にそろえる必要があります。

• -umc_content_id オプションでは、コンテンツ ID を指定します。この値を複数回指定する場合、指定する回数をバリアント ID を指定した回数にそろえる必要があります。

• -umc_variant_id オプションでは、バリアント ID を指定します。この値を複数回指定する場合、指定する回数をコンテンツ ID を指定した回数にそろえる必要があります。

次の例では、1 つのサブスクリプションビデオが指定されています。

次の例では、複数のサブスクリプションビデオが指定されています。

Transporter 出力情報やログ情報などのより詳細な例については、Status モード (ミュージックの例)、Status モード (ビデオの例)、StatusAll モードを参照してください。

パッケージの転送パフォーマンスをテストする際に、Transporter はテストパッケージを作成して既存の動作と統計を活用します。パッケージが正常にアップロードされると、Transporter はパッケージの合計伝送時間と詳細 (-throughput) を表示します。アップロードが失敗した場合、Transporter はその問題に関する通知、警告、またはエラーメッセージを返します。

-throughput が指定されているかどうかにかかわらず、Transporter はデフォルトでパッケージの合計伝送時間と詳細 (-throughput) を表示します。

Transfer Testモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m transferTest

• -u<username>

• -p<password>

• -k <kilobits_per_second> *

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-s<shortname>]

• [-itc_provider<shortname>]

• [-o<output>]

• [-errorLogs<path>]

• [-t <transport>] **

• [-size<value>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-indicator <true | false>]

• [-WONoPause <true | false>]

• [-outputFormat xml]

次の例では、Transporterがコマンドの実行を完了すると、eXtremeログ情報とともに、10メガバイト(10,000,000バイト)のパッケージの合計伝送時間と詳細(-throughput)をコンソールに返します。アップロード中、Transporterは指定されたプロバイダのファイルを10,000 Kbit/sのスロットル速度でSigniantサーバに転送します。

Transporter 出力情報やログ情報などのより詳細な例については、Transfer Testモードを参照してください。

App のアップロードは、macOS の他、Linux および Windows でもサポートされています。アップロードでは、-assetFile と -f のいずれのオプションも使用できます。Linux または Windows を使用する場合、-assetDescription 引数を使用して Xcode からのエクスポートで生成されるファイル (AppStoreInfo.plist ファイル) を指定する必要があります。このファイルの生成については、「Archive export files (英語)」を参照してください。

コンテンツをアップロードしているとき、“1023: Encoding house <encoding house name> is not yet authorized to deliver content (verify mode only)" というメッセージが表示された場合、Apple からアップロードのアクセス権が付与されていません。Apple のテクニカルパートナー担当者に問い合わせ、コンテンツをアップロードするアクセス権が付与されているかどうかを確認してください。

Apple では -t transport を指定せず、代わりに Transporter を使い、自動転送検出でパッケージに最適な転送モードを判別することを推奨しています。現在、Transporter では、最適な転送モードとしてデフォルトで HTTP が指定されます。-t transport を指定する必要がある場合も、できる限り早く自動転送検出に戻してください。エラーまたはサーバが使用不能であるために、指定された転送を使用できない場合、Transporter は転送の優先順位に基づいて別の転送を選択します。選択可能な転送オプションがなくなるまで、Transporter は次々と代替の転送モードを選択します。選択可能な転送オプションがなくなった時点で、デリバリが失敗します。カンマ (,) で区切って任意の順序でデリバリ方法を指定することによって、デフォルトの順序をオーバーライドできます。例：-t HTTP,Aspera,Signiant。転送オプションを 1 つのみ指定している場合 (-t Aspera)、Transporter はそのオプションを使用します。そのオプションが失敗した場合、ほかのオプションは選択されずにデリバリは失敗します。

Apple では、一度にデリバリするストアパッケージを 1,000 件以下にすることを推奨しています。

Uploadモードで、以下のコマンドラインオプションを指定する必要があります：

• -m upload

• macOS、Linux、Windows でアップロードを行う場合は、-f <dir | pkg> または -assetFile <.ipa | .pkg>

  注：-fオプションはアプリのアップロードに使用できません。アプリの場合は、代わりに-assetFileオプションを使用してください。

• -assetDescription AppStoreInfo.plist (LinuxとWindowsでのアップロードには-assetDescriptionが必須です)

• -u<username>

• -p<password>

• -k <kilobits_per_second> *

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-s<shortname>]

• [-itc_provider<shortname>]

• [-asc_provider<shortname>]

• [-o<output>]

• [-summaryFile<output>]

• [-errorLogs<path>]

• [-eventFile<path>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-t<transport>]

• [-success<path>]

• [-failure<path>]

• [-throughput]

• [-loghistory<path>]

• [-delete]

• [-Xmx4096m]

• [-indicator <true | false>]

• [-WONoPause <true | false>]

• [-deleteFastTransportLog <true | false>] **

• [-assetReplacementVerification <true | false>]

• [-outputFormat xml]

• [-vp <text | json>]

Upload Asset Packは、macOSのほか、LinuxとWindowsでもサポートされています。-assetFileを使用してBackground Assetsの圧縮アーカイブファイルを指定し、-assetPackIdを使用してそのBackground Assetsに関連付けたIDを指定します。後者は、LinuxとWindowsで必須です。-apple_idを使用して、このBackground Assetsのアセットパックに関連付けられているアプリを指定します。

Upload Asset Packモードでは、以下のコマンドラインオプションを指定する必要があります。

• -m uploadAssetPack

• -assetFile<path_to_aar_file>

• -assetPackId <id> (このアセットパックのデベロッパID。LinuxとWindowsでのアップロードには-assetPackIdが必須です)

• -apple_id<id> (アプリケーションのApple ID)

• -u<username>

• -p<password>

• -asc_provider <shortname> (ユーザ名とパスワードの認証に必須)

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-v <off | informational | critical | detailed | eXtreme>]

Apple では現在、EPUB ファイル（.epub）と iBooks 形式のファイル（iBooks）の検証のみをサポートしています。

Validate Assetsモードでは、以下のコマンドラインオプションを指定する必要があります：

• -m validateRawAssets

• -u<username>

• -p<password>

• -assetFolder <path> または -assetFile <path>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-s<shortname>]

• [-itc_provider<shortname>]

• [-success<path>]

• [-failure<path>]

• [-o<output>]

• [-v <off | informational | critical | detailed | eXtreme>]

このモードは、ユーザがパブリッシャーの場合にのみ有効です。アプリデベロッパの場合は、Validate Assetsモードを使用できません。

以下の例では、Transporter はコマンドの実行を完了すると、eXtreme ログ情報をコンソールに返します。ログ情報には、 /tmp/assets ディレクトリにある指定されたプロバイダのアセットファイルがそれぞれが有効かどうかに関する情報が含まれます。

Transporter 出力情報やログ情報などのより詳細な例については、Validate Assetsモードを参照してください。

検証のためにパッケージを Apple に送信する際に、Transporter はメタデータファイルを解析し、ファイルが適切なフォーマットであること、データ (日付や製品など) が正しいことを確認します。また Transporter は Apple に送信するすべてのアセット (オーディオファイル、ビデオファイル、ブックファイル、App など) も検証します。

Verifyモードは、以下のコマンドラインオプションを指定する必要があります：

• -m verify

• macOS、Linux、Windows でアップロードを行う場合は、-f <dir | pkg> または -assetFile <.ipa | .pkg>

  注：-fオプションは、アプリの検証に使用できません。アプリの場合は、代わりに-assetFileオプションを使用してください。

• -u<username>

• -p<password>

オプションで、以下の追加のコマンドラインオプションを指定できます：

• [-s<shortname>]

• [-itc_provider<shortname>]

• [-disableAssetVerification]

• [-o<output>]

• [-summaryFile<output>]

• [-errorLogs<path>]

• [-eventFile<path>]

• [-v <off | informational | critical | detailed | eXtreme>]

• [-Xmx4096m]

• [-WONoPause <true | false>]

• [-outputFormat xml]

• [-vp <text | json>]

以下の例では、Transporter がコマンドの実行を完了したときに、eXtreme ログ情報をコンソールに返します。これには、/tmp/packages ディレクトリにある指定したプロバイダのパッケージ、ファイル、メタデータ、およびアセットがそれぞれ有効であるかどうかに関する情報が含まれます。

Transporter 出力情報やログ情報などのより詳細な例については、Verifyモードを参照してください。

次の例でユーザ bob は、Transporter を Create Artist モードで実行し、Transporter で「Juan Pérez」という名前の新しいミュージックアーティストを作成するよう指定しています。

Transporter は、アーティスト「Juan Pérez」はすでに存在するために作成されなかったことを示す情報を返します。また、Transporter は、force-creation トークン ("1d82c6f6-26ef-3e28-8a97-558c7c5717da") も返します。このトークンを使用して Transporter で強制的に新しいミュージックアーティストを作成することができます。

Transporter で強制的に新しいミュージックアーティストを作成するには、コマンドに -forceCreateToken "1d82c6f6-26ef-3e28-8a97-558c7c5717da" を追加します。

Transporter ではアーティスト「Juan Pérez」が作成されたことを示す情報を返します。

Transporter は、メタデータチケットが正常に作成されたことを示す情報を返し、eXtreme ログ情報を表示します。

Transporter は過去 30 日間のすべてのプロバイダのカタログレポートのリストを返し eXtreme ログ情報を表示します。

この例で、Transporter はリクエストの日付 (03/21/2013 12:11 PDT)、レポートをリクエストしたユーザ名 (Bob)、コンテンツタイプ (TV Show)、およびステータス (Succeeded) を表示し、レポートのリクエストが成功したことを示しています。

コマンドの実行が完了すると、Transporter はBobがコンテンツをデリバリする権限を持つ対象のプロバイダのロングネームとショートネームのリストを表示します。その他のログ情報は表示されません。

この例ではユーザ bob に、次の 1 つのプロバイダにコンテンツをデリバリする許可が付与されています。Apple Computer (ロングネーム)、Apple (ショートネーム)。このプロバイダにアセットをアップロードする際は、-s オプションでショートネーム (「Apple」) を指定します。

Transporter はなおも注意を必要とするすべての未対応チケットに関する情報を返し、eXtreme ログ情報を表示します。

この例で Transporter は、 2 つの未対応チケット (ticketId=97202 と ticketId=135986) の情報と、実行する必要があるアクションの詳細 (「The wrong cover art has been submitted for this album.」および「Wrong cover art. Album title and artist name do not match.」) を表示しています。

Transporter は unmanifested.epub の EPUB ファイルを修復し、EPUB ファイルからマニフェストに含まれなかったファイルを削除してから、修復したファイルを /tmp/repairEpubAssetsUnmanifested/ ディレクトリに保存しようと試みます。Transporter がコマンド実行を終了すると、ファイルを修復できたかどうかを示す情報を表示します。

この例で Transporter は、unmanifested.epub の EPUB ファイルを修復しました。Transporter は修復されたファイルパス (/tmp/repairEpubAssetsUnmanifested/unmanifested.epub) とチェックサム (8dd1e064ae5cdde7b1b3c8d766db92ee) を表示します。

Transporter は過去 30 日間のすべてのプロバイダのカタログレポートを /tmp/ ディレクトリにダウンロードし、eXtreme ログ情報を表示します。

この例では、 Transporter は次のカタログレポートが /tmp/ ディレクトリにダウンロードされたことを示しています： Apple_TV.ljjwjfgf.zip および Apple_TV.ljjwjfgf.zip.

Transporter は、ストアパッケージ映画仕様バージョン 4.7 の Transitional スキーマファイルを返し、eXtreme ログ情報を表示します。

この例では、Transporter は暫定スキーマファイルを /tmp/schema/film4.7-transitional.rng に保存します。