エラー処理

エラーが発生した場合、Alexaが具体的なアクションを行えるように、レスポンスでエラーコードを返す必要があります。

エラーメッセージの構造
検索結果が見つからない場合
エラーの例： CONTENT_NOT_FOUND
エラータイプ

エラーメッセージの構造

ErrorResponseイベントのペイロードでは、typeとmessageを指定する必要があります。

type：発生したエラーの種類を示す有効なエラータイプの値のいずれか。Alexaはこの属性を使用して、ユーザーに適切に対応します。
message：エラーについての詳しい情報を提供する文字列。この情報はユーザーには共有されません。

検索結果が見つからない場合

マルチモーダルデバイスのビデオスキルでは、検索結果が見つからない場合、次のエラーを使用する必要があります。

エラータイプ	説明
`CONTENT_NOT_FOUND`	ディレクティブで送信された条件ではコンテンツが見つからない、またはコンテンツのプロバイダーでコンテンツが認識されていないことを示すには、この値を使用する必要があります。

エラーの例： CONTENT_NOT_FOUND

{
    "event": {
        "header": {
            "messageId": "4e02d3c8-85e8-4e32-8a1b-08c1d52122ad",
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/==",
            "name": "ErrorResponse",
            "namespace": "Alexa.Video",
            "payloadVersion": "3"
        },
        "endpoint": {
            "scope": {
                "type": "DirectedUserId",
                "directedUserId": "access-token-from-Amazon"
            },
            "endpointId": "videoDevice-001"
        },
        "payload": {
            "message": "Alexaによってログに記録されるエラーに関する追加情報",
            "type": "CONTENT_NOT_FOUND"
        }
    }
}

エラータイプ

typeで使用するすべてのオプションを次の表に示します。

タイプ	説明
`CONTENT_NOT_FOUND`	ディレクティブで送信された条件を満たすコンテンツが見つからない場合、またはコンテンツプロバイダーによってコンテンツが認識されない場合は、この値を使用します。
`INVALID_AUTHORIZATION_CREDENTIAL`	リクエスト内の認証情報が無効です。たとえば、ユーザーのアカウントで、OAuth 2.0アクセストークンが有効ではありません。
`EXPIRED_AUTHORIZATION_CREDENTIAL`	リクエスト内のOAuth 2.0アクセストークンの有効期限が切れています。