チュートリアル:音声によるアカウントリンクを実装する(LWA)
Note: Sign in to the developer console to build or publish your skill.
チュートリアル:音声によるアカウントリンクを実装する(LWA)
注: このページでは、提供するサービスがユーザーのサインインメカニズムとしてLogin with Amazon(LWA)を使用している場合に、音声によるアカウントリンクを実装する方法について説明します。
以下のチュートリアルでは、Alexaユーザーが、音声を使ってスキルサービスで使うアカウントをAmazonアカウントにリンクさせるための手順を紹介します。
音声によるアカウントリンクの概要については、Alexaスキルで音声によるアカウントリンクを使用する(LWA)を参照してください。
カスタムスキルに音声によるアカウントリンクを実装する手順
カスタムスキルに音声によるアカウントリンクを実装するには、次の手順に従います。
ステップ1: 要件を確認する
前提条件で、スキルとウェブサイトの要件、ユーザーの要件を確認します。
ステップ2: カスタムスキルを設定し、アカウントリンクを実装する
音声によるアカウントリンクのコードを追加する前に、カスタムスキルを設定して従来のアカウントリンクを実装する必要があります。
注: このアカウントリンクを実装するカスタムスキルは、パーソナライズをサポートできません。つまり、ツール > アクセス権限 > スキルのパーソナライズを無効にする必要があります。
カスタムスキルを設定し、従来のアカウントリンクを実装する
- Alexa開発者コンソールにサインインし、カスタムスキルに移動します。
- ビルドタブをクリックします。
- 左側のツールをクリックし、アカウントリンクをクリックします。
- ユーザーがアカウントや既存アカウントへのリンクを作成することを許可しますか?を有効にします。
- アカウントリンクを任意のままにしておきたい場合、アカウントリンクなしでスキルを有効にすることをユーザーに許可します(推奨)を有効にします。
- ユーザーが音声を使用して自分のアカウントをスキルにリンクすることを許可するを有効にします。
注: Alexa Skills Kit(ASK)スキル管理APIのアカウントリンクの更新操作を使って、音声によるアカウントリンクを有効にすることもできます。
- Authorization code grantを設定するの情報に基づいて残りのアカウントリンク設定を入力し、スキルを保存します。
- 従来のアカウントリンクを実装します。実装の詳細については、スキルへのアカウントリンクの実装手順を参照してください。
ステップ3: スキルコードに音声によるアカウントリンクを追加する
ここでは、カスタムスキルのコードに音声によるアカウントリンクを追加する手順について説明します。
音声によるアカウントリンクを追加する
- Amazonが管理する音声によるアカウントリンクスキルに制御を渡すことで、アカウントリンクを開始するハンドラーを実装します。
詳細については、音声によるアカウントリンク開始タスクをリクエストするハンドラーを実装するを参照してください。 - アカウントリンクタスクが完了した後、Amazonが管理する音声によるアカウントリンクスキルから応答を受信するハンドラーを実装します。
詳細については、音声によるアカウントリンクを開始するタスクの応答を取得するハンドラーを実装するを参照してください。 - アカウントリンクのほかの方法と同様に、Alexaのリクエストからユーザーのアクセストークンを取得・検証し、リソースサーバーから必要なユーザー情報を取得するスキルコードを追加する必要があります。
スキルがリソースサーバーを持たない場合、LWAを呼び出すことでLWAのuser_id
を取得できます。 - (任意)ユーザーのプロフィール情報が必要な場合は、音声によるアカウントリンクフローが完了したときにCustomer Profile APIを呼び出すフォールバックロジックを追加してください。これは、音声によるアカウントリンクフロー中に取得したアカウントリンクトークンが
profile:user_id
スコープに限定されるためです。ユーザープロフィール情報を取得するには、以下の手順に従います。- 音声によるアカウントリンクの応答で受け取ったアクセストークンを使ってLWAを呼び出し、ユーザーの
user_id
を取得します。 - 返された
apiAccessToken
を使ってCustomer Profile APIを呼び出し、ユーザーの情報を取得します。
注: スキルが既にLWAを使っていて、ユーザーがアプリでアカウントリンクを完了した後に取得したaccessToken
を使ってLWAを呼び出すことで、ユーザーのプロフィール情報にアクセスしている場合、同じ機能を実現できるフォールバックロジックを追加する必要があります。フォールバックロジックでは、音声によるアカウントリンクが成功した後にスキルがリクエストで受け取ったapiAccessToken
を使って、Customer Profile APIを呼び出します。 - 音声によるアカウントリンクの応答で受け取ったアクセストークンを使ってLWAを呼び出し、ユーザーの
ステップ4: 実装をテストする
開発者コンソールを使用して、次のように実装をテストします。
実装をテストするには
- Alexa開発者コンソールにサインインします。
- スキルリストからスキルを選択します。
- 上部のテストタブをクリックします。
- 左上のヘッダーバーの下にあるスキルテストが有効になっているステージで、開発中を選択します。
詳細については、開発者コンソールでスキルをテストするを参照してください。別の方法として、iOSやAndroidのモバイルデバイスにインストールしたAlexaアプリを使ってスキルをテストすることもできます。詳細については、Alexaアプリでテストするを参照してください。 - Echoデバイスでスキルを起動し、音声によるアカウントリンクのユーザーエクスペリエンスに示されている例など、さまざまなシナリオでテストします。
- 音声プロフィールのないテストアカウントや、スキルをパーソナライズが有効になっていない音声プロフィールなど、さまざまなユーザーアカウント設定をテストします。
ステップ5: スキルの認定を受ける
スキルをビルドし、自身のアカウントでテストしたら、スキルの認定を申請できます。カスタムスキルの認定の詳細については、認定の要件を参照してください。
関連トピック
- Alexaスキルで音声によるアカウントリンクを使用する(LWA)
- 音声によるアカウントリンクの実装について(LWA)
- クイックリファレンス: Alexaスキルにアカウントリンクを追加する
- アカウントリンクの構成要素
最終更新日: 2022 年 08 月 15 日