スキルのロールバック（SMAPI）

スキルのロールバック

スキルのロールバック機能により、スキルの再認定を手動で再申請することなく、スキルを以前に公開したバージョンに戻すことができます。このプロセスは、開発サイクル間を移動する際に役立ちます。たとえば、新しいスキルバージョンでバグやその他の意図しない動作が発生した場合に、スキルのロールバックを選択できます。

スキルをロールバックするには、Alexa Skills Kit（ASK）のコマンドラインインターフェース（CLI）、SMAPI API、開発者コンソールのいずれかを使用します。

注：スキルビルダーが新しいスキルロールバック機能を活用できるように、2020年7月中旬に最初の資格要件を満たした特定のカスタムスキルおよび音楽スキルについて、公開中のバージョンの追跡を開始しました。このシステムの更新は自動的に行われました。公開中のスキルが資格要件を満たしていた場合は、公開中のスキルの日付が更新されました。この日付は、開発者コンソールのランディングページのスキルの更新日列か、リストスキルAPIのlastUpdatedフィールドで確認できます。これらのスキルに対して、それ以外の変更は行われていません。スキルのバージョンをロールバックできるかどうかは、list-versions CLIコマンドを使用して確認します。

スキルバージョンのロールバックの資格要件

スキルのバージョンのロールバック要件を満たしていれば、ロールバックした場合でもスキルのバージョンはAmazonのポリシーテスト要件に準拠し続けるため、問題は発生しません。

サポートしている機能によっては、次のリストはすべてを網羅していない場合があります。また、スキルは例外なく、Amazonの認定条件にも合格する必要があります。これには、Amazonのコンテンツガイドラインを遵守していることも含まれます。これらのコンテンツガイドラインの詳細については、Alexaスキルのポリシーのテストを参照してください。

注：特定の機能を使用するスキルはロールバックの対象外です。たとえば、アカウントリンクのバージョン間の変更をサポートするスキルはロールバックの対象外です。

以下に、スキルバージョンをロールバックするための条件を示します。

カスタムスキルと音楽スキルのみが対象となる。
スキル開発サイクルでバージョンを使用している。詳細については、スキルをバージョン管理して任意のバージョンメッセージを追加するを参照してください。
戻す先のスキルのバージョンが過去6か月以内に認定に合格している。
戻す先のスキルのバージョンが制限中、不合格、取り下げになっていない。
バージョン間で新しいロケールをスキルに追加していない。
バージョン間でスキル内課金（ISP）やアカウントリンクの追加も変更も行っていない。
バージョン間でスキルの呼び出し名を変更していない。
バージョン間で子ども向けスキルから通常スキルに変更していない。
スキルは現在「審査中」または公開段階ではありません。これには、公開中スキルへの即時更新も含まれます。

開発者コンソールを使用してスキルをロールバックする

スキルをロールバックするには、認定ページのバージョン履歴タブを使用します。

注：スキル開発サイクルでバージョンが使用され、バージョンメッセージが関連付けられている場合にのみ、スキルバージョンをロールバックできます。バージョンメッセージの送信方法の詳細については、スキルをバージョン管理して任意のバージョンメッセージを追加するを参照してください。

以前に公開したスキルのバージョンにロールバックするには

ASK開発者コンソールにサインインします。
認定タブをクリックし、バージョン履歴タブをクリックします。

スキルの認定を申請するたびに、バージョン履歴ページに表示される表に、申請済みのバージョンが表示されます。
表の中からロールバックするスキルのバージョンを見つけます。

バージョンメッセージ列のメッセージを読んで、正しいスキルであることを確認します。これらは、スキルのバージョンメッセージを送信したときに記述したメッセージと同じものです。
アクション列でロールバックをクリックします。
確認ボックスでロールバックを選択します。

ロールバックのステータス

ロールバックが成功した場合は、ロールバックに成功しましたというメッセージが表に表示されます。
ロールバックが失敗した場合は、ロールバックに失敗しましたというメッセージが表に表示されます。

CLIを使用してスキルをロールバックする

CLIでのロールバックの使用方法の詳細については、CLIリファレンスのrollback-skillおよびget-rollback-for-skillを参照してください。

SMAPI APIを使用してスキルをロールバックする

SMAPI APIでのロールバックの使用方法の詳細については、スキルのロールバックを参照してください。

よくある質問

ロールバックをサポートするスキルの種類は何ですか？: 現時点では、カスタムスキルと音楽スキルがスキルのロールバックをサポートしています。すべてのスキルは、最低限の資格要件を満たしている必要があります。ロールバックの対象となるバージョンを識別する方法の詳細については、スキルバージョンのロールバックの資格要件を参照してください。
スキルをロールバックすると、どのスキルアセットが変更されますか？: ロールバックは、スキルリソースレベルではなく、スキルレベルで機能します。ロールバックされるスキルアセットは、マニフェストデータと対話モデルです。Amazonが所有するアーティファクト（ビルトインインテント、スロット、フォーマッタ、トークナイザーなど）は、以前のバージョンにロールバックされません。
スキルのロールバックによって、まだ開発中のスキルを変更できますか？: いいえ。スキルのロールバックでは、開発段階のスキルは変更できません。
認定済みのバージョンでは、開発者コンソールのロールバックボタンがグレー表示されるのはなぜですか？: スキルバージョンがロールバックの対象外であるためです。ロールバックの対象となるバージョンを識別する方法の詳細については、スキルバージョンのロールバックの資格要件を参照してください。
スキルバージョンをロールバックしました。Alexaスキルストアにロールバック前に使用していた以前のバージョンが表示されるのはなぜですか？: ロールバックが完了し、バージョン履歴ページでスキルバージョンが公開中になると、既にスキルを有効にしているユーザーは自動的に新しい公開バージョンにロールバックされます。これらの変更は、直後にAlexaスキルストアに反映されます。

開発者コンソール：