会話型アクションのサポートは 2023 年 6 月 13 日に終了しました。詳細については、会話型アクションの廃止をご覧ください。

OAuth によるアカウントリンク（Dialogflow）

OAuth リンクタイプは、インプリシットフローと認可コードフローの 2 通りの業界標準 OAuth 2.0 フローをサポートします。

在隐式代码流程中，Google 会在用户浏览器中打开您的授权端点。成功登录后，系统会向 Google 返回长期访问令牌。现在，从 Google 助理向你的 Action 发送的每个请求中都包含此访问令牌。

在授权代码流程中，您需要两个端点：

授权端点，该端点负责向尚未登录的用户显示登录界面，并以短期授权代码的形式记录所请求的访问。
令牌交换端点，负责两种类型的交换：
1. 将授权代码交换为长期刷新令牌和短期访问令牌。用户完成帐号关联流程后，系统会进行这种交换。
2. 将长期刷新令牌换成短期访问令牌。Google 需要新访问令牌时，由于此令牌已过期，因此会进行此交换。

虽然隐式代码流程的实现更简单，但 Google 建议通过隐式流程发出的访问令牌永远不会过期，因为将令牌过期与隐式流程一起使用会强制用户再次关联其帐号。如果出于安全考虑需要令牌到期，强烈建议您考虑使用身份验证代码流程。

OAuth によるアカウントリンクを実装する

プロジェクトを構成する

プロジェクトで OAuth によるアカウントリンクを使用するよう構成するには、次の手順に従います。

Actions Console を開き、使用するプロジェクトを選択します。
[Develop]（開発）タブをクリックして、[Account linking]（アカウントリンク）を選択します。
[アカウントのリンク] の横にあるスイッチを有効にします。
[アカウントの作成] セクションで、[いいえ、ウェブサイトでのアカウントの作成のみを許可します。] を選択します。
[Linking type] で、[OAuthOAuth] と [ImplicitOAuth] を選択します。
[Client Information]（クライアント情報）で、次の操作を行います。
- [Client ID served by your Actions to Google] に、識別する値を割り当てます。リクエストの数を減らすことができます。
- 認可エンドポイントとトークン交換エンドポイントの URL を挿入します。

で確認できます。

[保存] をクリックします。

OAuth サーバーを実装する

OAuth 2.0 暗黙的フローをサポートするために、サービスは使用できます。このエンドポイントは、認証と認可を担当します。データアクセスについてユーザーから同意を得る。認可エンドポイントは、ログインしていないユーザーにログイン用の UI を表示し、リクエストされたアクセスへの同意を記録します。

アクションからサービスの API を呼び出す必要がある場合、Google はこのエンドポイントを使用して、API の呼び出し許可をユーザーから取得します。

通常、Google が開始する OAuth 2.0 インプリシットフローのセッションは次のような流れになります。

Google がユーザーのブラウザで認可エンドポイントを開きます。ユーザーがログインし（ログインしていない場合）、Google が API を使用してデータにアクセスすることを承諾します（まだ許可していない場合）。
サービスがアクセストークンを作成します。そのトークンを含むリクエストを送信して、ユーザーのブラウザを Google にリダイレクトし、Google にアクセストークンを返します。
Google がサービスの API を呼び出し、リクエストごとにアクセストークンを関連付けます。サービスは、アクセストークンによって API へのアクセスが Google に許可されていることを確認し、API 呼び出しを完了します。

認可リクエストの処理

アクションで OAuth2 インプリシットフローを介してアカウントリンクを行う必要がある場合、Google は、次のパラメータを含むリクエストを使用して、ユーザーを認可エンドポイントに送信します。

認可エンドポイントのパラメータ
`client_id`	Google に割り当てたクライアント ID。
`redirect_uri`	このリクエストに対するレスポンスを送信する URL。
`state`	リダイレクト URL で変更されずに Google に返される会計上の値。
`response_type`	レスポンスで返される値のタイプ。OAuth 2.0 暗黙の API では、レスポンスタイプは常に `token` です。

たとえば、認可エンドポイントが https://myservice.example.com/auth にある場合、次のようなリクエストになります。

GET https://myservice.example.com/auth?client_id=GOOGLE_CLIENT_ID&redirect_uri=REDIRECT_URI&state=STATE_STRING&response_type=token

認可エンドポイントでログインリクエストを処理する場合は、次の手順に従います。

client_id と redirect_uri の値を検証する意図しないクライアントアプリへのアクセスや構成ミスのあるクライアントアプリ
- client_id が、指定したクライアント ID と一致することを確認します。割り当てられています
- redirect_uri で指定された URL を確認します。パラメータの形式は次のとおりです。
```
https://oauth-redirect.googleusercontent.com/r/YOUR_PROJECT_ID
```
  YOUR_PROJECT_ID は、[プロジェクトの設定] ページにある ID です。確認できます。
ユーザーがサービスにログインしているかどうか確認します。ユーザーがログインしていない場合は、サービスのログインまたは登録フローを完了します。
Google が API へのアクセスで使用するアクセストークンを生成します。アクセストークンには任意の文字列値を設定できますが、トークンを使用するユーザーとクライアントを一意に表し、簡単に推測されない文字列にする必要があります。
ユーザーのブラウザを URL にリダイレクトする HTTP レスポンスを送信する redirect_uri パラメータで指定します。URL フラグメントに次のパラメータをすべて含めます。
- access_token: 生成したアクセストークン
- token_type: 文字列 bearer
- state: 元の状態から変更されていない状態の値リクエスト結果の URL の例を次に示します。
```
https://oauth-redirect.googleusercontent.com/r/YOUR_PROJECT_ID#access_token=ACCESS_TOKEN&token_type=bearer&state=STATE_STRING
```

Google の OAuth 2.0 リダイレクトハンドラがアクセストークンを受け取り、 state 値が変更されていないことを確認します。Google は、そのトークンを後続の呼び出しにアタッチします。 AppRequest の一部としてアクションに渡します。

認証フローを開始する

アカウントログインヘルパーインテントを使用して認証フローを開始します。次のコードスニペットは、Dialogflow と Actions SDK でこのヘルパーを使用してレスポンスを送信する方法を示します。

Dialogflow:

</ph> <ph type="x-smartling-placeholder">

</ph>

Node.js

const {dialogflow, SignIn} = require('actions-on-google');
const app = dialogflow({
  // REPLACE THE PLACEHOLDER WITH THE CLIENT_ID OF YOUR ACTIONS PROJECT
  clientId: CLIENT_ID,
});
// Intent that starts the account linking flow.
app.intent('Start Signin', (conv) => {
  conv.ask(new SignIn('To get your account details'));
});

をご覧ください。 <ph type="x-smartling-placeholder">

</ph>

Java

@ForIntent("Start Signin")
public ActionResponse text(ActionRequest request) {
  ResponseBuilder rb = getResponseBuilder(request);
  return rb.add(new SignIn().setContext("To get your account details")).build();
}

をご覧ください。 <ph type="x-smartling-placeholder">

</ph>

JSON

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "PLACEHOLDER"
            }
          }
        ]
      },
      "userStorage": "{\"data\":{}}",
      "systemIntent": {
        "intent": "actions.intent.SIGN_IN",
        "data": {
          "@type": "type.googleapis.com/google.actions.v2.SignInValueSpec",
          "optContext": "To get your account details"
        }
      }
    }
  },
  "outputContexts": [
    {
      "name": "/contexts/_actions_on_google",
      "lifespanCount": 99,
      "parameters": {
        "data": "{}"
      }
    }
  ]
}

Actions SDK:

</ph> <ph type="x-smartling-placeholder">

</ph>

Node.js

const {actionssdk, SignIn} = require('actions-on-google');
const app = actionssdk({
  // REPLACE THE PLACEHOLDER WITH THE CLIENT_ID OF YOUR ACTIONS PROJECT
  clientId: CLIENT_ID,
});
// Intent that starts the account linking flow.
app.intent('actions.intent.TEXT', (conv) => {
  conv.ask(new SignIn('To get your account details'));
});

をご覧ください。 <ph type="x-smartling-placeholder">

</ph>

Java

@ForIntent("actions.intent.TEXT")
public ActionResponse text(ActionRequest request) {
  ResponseBuilder rb = getResponseBuilder(request);
  return rb.add(new SignIn().setContext("To get your account details")).build();
}

をご覧ください。 <ph type="x-smartling-placeholder">

</ph>

JSON

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "inputPrompt": {
        "richInitialPrompt": {
          "items": [
            {
              "simpleResponse": {
                "textToSpeech": "PLACEHOLDER"
              }
            }
          ]
        }
      },
      "possibleIntents": [
        {
          "intent": "actions.intent.SIGN_IN",
          "inputValueData": {
            "@type": "type.googleapis.com/google.actions.v2.SignInValueSpec",
            "optContext": "To get your account details"
          }
        }
      ]
    }
  ],
  "conversationToken": "{\"data\":{}}",
  "userStorage": "{\"data\":{}}"
}

データアクセスリクエストを処理する

アシスタントのリクエストにアクセストークンが含まれている場合は、まずそのアクセストークンが有効で期限切れになっていないことを確認してから、関連付けられているユーザーアカウントをデータベースから取得します。

OAuth によるアカウント リンク（Dialogflow） コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

OAuth によるアカウント リンクを実装する

プロジェクトを構成する

OAuth サーバーを実装する

認可リクエストの処理

認証フローを開始する

Dialogflow:

Actions SDK:

データアクセス リクエストを処理する

OAuth によるアカウントリンク（Dialogflow）

OAuth によるアカウントリンクを実装する

データアクセスリクエストを処理する