スマートホームなどのドメインのアカウントリンク
すべてのスマートホームスキルとビデオスキルは、AlexaユーザーのIDとデバイスクラウドシステムのIDを接続するためにアカウントリンクを実装する必要があります。一部の音楽スキルもアカウントリンクをサポートしています。
アカウントリンクの概念については、アカウントリンクの構成要素を参照してください。ユーザーエクスペリエンスについては、Alexaスキルにおけるユーザーのアカウントリンク体験を参照してください。
カスタムスキルのアカウントリンクの詳細については、カスタムスキルのアカウントリンクを参照してください。
前提条件
スマートホームスキルにアカウントリンクを実装するには、以下の前提条件があります。
- システムはOAuth 2.0とAuthorization code grant種別をサポートしている必要があります。
独自の認可サーバーがない場合、Login with Amazon(LWA)、またはAmazon認定の認証局によって署名された証明書を保有するほかのOAuth 2.0プロバイダーを使用することができます。このリストに記載されていても、https://letsencrypt.org/
を使用することはできませんので注意してください。 - OAuthプロバイダーは、Alexaスキルにおけるアカウントリンクの要件を満たしている必要があります。
アカウントリンクの設定
Alexa開発者コンソールのTOOLS > アカウントリンクセクションでスキルにアカウントリンクを設定します。
アカウントリンクのコンフィギュレーションフィールド、アクセストークン、Authorization code grantフロー全体の詳細については、Authorization code grantを設定するを参照してください。
アカウントリンク処理を追加してスキルコードを更新する
スキルに送信される各ディレクティブには、ユーザーを識別するアクセストークンが含まれます。スキルコードは、トークンを検証してから、そのトークンをユーザーに関する情報にアクセスするために使用する必要があります。詳細については、以下のトピックを参照してください。
また、スキルのAlexaイベントを送る権限を有効にしている場合、スキルはAcceptGrant
ディレクティブを処理する必要があります。スキルがこのディレクティブを処理しない場合、ユーザーがスキルを有効にしようとするとアカウントリンクは失敗します。詳細については、Alexaイベントゲートウェイへのアクセス権限のリクエストを参照してください。
自動登録
自動登録を使用すると、ユーザーがデバイスセットアップ時にシステムへの自動登録およびそのIDとAlexa IDのリンクを行えるようにスキルで設定することができます。この機能を使用するには、Amazonのビジネス開発担当者にご相談いただくか、こちらからお問い合わせください。
関連トピック
- スマートホームとビデオのスキルコードでアクセストークンを検証して使用する
- ミュージックスキルコードでアクセストークンを検証して使用する
- クイックリファレンス: Alexaスキルにアカウントリンクを追加する
- Alexaスキルにアカウントリンクを追加する
- アカウントリンクの構成要素
最終更新日: 2025 年 09 月 19 日