スキルのロールバック(SMAPI)

スキルのロールバック

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

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

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

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

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

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

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

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

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

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

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

    スキルの認定を申請するたびに、バージョン履歴ページに表示される表に、申請済みのバージョンが表示されます。

  3. 表の中からロールバックするスキルのバージョンを見つけます。

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

  4. アクション列でロールバックをクリックします。
  5. 確認ボックスでロールバックを選択します。

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

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

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

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

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

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

よくある質問

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

開発者コンソール: