スキルのロールバック(SMAPI)
スキルのロールバック機能により、スキルの再認定を手動で再申請することなく、スキルを以前に公開したバージョンに戻すことができます。このプロセスは、開発サイクル間を移動する際に役立ちます。たとえば、新しいスキルバージョンでバグやその他の意図しない動作が発生した場合に、スキルのロールバックを選択できます。
スキルをロールバックするには、Alexa Skills Kit(ASK)のコマンドラインインターフェース(CLI)、SMAPI 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スキルストアに反映されます。
関連トピック
開発者コンソール: