InitiateOAuth
OAuth アクセストークンを取得またはリフレッシュするプロセスを指定します。これにより、認証された認可ユーザーが作業している間、ユーザーアクセスを維持することができます。
Possible Values
OFF, REFRESH, GETANDREFRESHデータ型
string
デフォルト値
"GETANDREFRESH"
解説
OAuth は、アプリケーションがHTTP サービス上のユーザーアカウントに限定的にアクセスすることを可能にする認可フレームワークです。OAuth フローは、以下の用途で使用される方法を定義します。
- ユーザーのログイン。
- 認証に使用するOAuth アクセストークンとユーザー認証情報の交換。
- アプリケーションへの限定的なアクセスの提供。
OAuth アクセスの開始と維持のオプションは、本製品 が処理するフローの部分に基づいて命名されています。
| OFF | 本製品 はOAuth フローの自動開始を提供しません。OAuth フローはユーザーによってすべて操作されます。 つまり、ユーザーがトークンを手動でリフレッシュし、現在のトークンが期限切れになった際に更新されたOAuthAccessToken プロパティで再接続する必要があります。 |
| GETANDREFRESH | 本製品 が完全なOAuth フロー（GET とREFRESH の両方）を処理します。つまり、トークンが既に存在する場合は本製品 が必要に応じて更新し、その時トークンが存在しない場合は本製品 がユーザーにログインを促してトークンを取得します。 |
| REFRESH | ユーザーがOAuth アクセストークンを取得し、OAuth アクセストークンのリフレッシュシーケンスを設定します。（ユーザーは認証のためにログインを求められることはありません。）ユーザーがログインした後、本製品 がOAuthアクセストークンのリフレッシュを操作します。） |
OAuth の設定方法や、接続設定時にこのプロパティを使用する方法の詳細については、接続の確立 を参照してください。