翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AppFabric for productivity APIsプレビュー)
<a name="productivity-apis"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

このセクションでは、 AWS AppFabric 生産性向上機能の API オペレーション、データ型、一般的なエラーについて説明します。

**注記**  
その他の AppFabric API については、「[AWS AppFabric API Reference](https://docs.aws.amazon.com/appfabric/latest/api/)」を参照してください。

**Topics**
+ [AppFabric for productivity の API アクション (プレビュー)](productivity-actions.md)
+ [AppFabric for productivity の API データ型 (プレビュー)](productivity-data-types.md)
+ [AppFabric for productivity の一般的な API エラー (プレビュー)](productivity-common-errors.md)

# AppFabric for productivity の API アクション (プレビュー)
<a name="productivity-actions"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

AppFabric for productivity 機能では、次のアクションがサポートされています。

AppFabric API のその他のアクションについては、「[AWS AppFabric API Actions](https://docs.aws.amazon.com/appfabric/latest/api/API_Operations.html)」を参照してください。

**Topics**
+ [承認](API_Authorize.md)
+ [CreateAppClient](API_CreateAppClient.md)
+ [DeleteAppClient](API_DeleteAppClient.md)
+ [GetAppClient](API_GetAppClient.md)
+ [ListActionableInsights](API_ListActionableInsights.md)
+ [ListAppClients](API_ListAppClients.md)
+ [ListMeetingInsights](API_ListMeetingInsights.md)
+ [PutFeedback](API_PutFeedback.md)
+ [トークン](API_Token.md)
+ [UpdateAppClient](API_UpdateAppClient.md)

# 承認
<a name="API_Authorize"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

AppClient を認証します。

**Topics**
+ [リクエストボディ](#API_Authorize_request)

## リクエストボディ
<a name="API_Authorize_request"></a>

リクエストは以下の JSON 形式のデータを受け入れます。


| パラメータ | 説明 | 
| --- | --- | 
|  **app\$1client\$1id**  |  承認する AppClient の ID です。  | 
|  **redirect\$1uri**  |  承認後にエンドユーザーがリダイレクトされる URI です。  | 
|  **state**  |  リクエストとコールバック間の状態を維持するための一意の値です。  | 

# CreateAppClient
<a name="API_CreateAppClient"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

AppClient を作成します。

**Topics**
+ [リクエストボディ](#API_CreateAppClient_request)
+ [レスポンス要素](#API_CreateAppClient_response)

## リクエストボディ
<a name="API_CreateAppClient_request"></a>

リクエストは以下の JSON 形式のデータを受け入れます。


| パラメータ | 説明 | 
| --- | --- | 
|  **appName**  |  アプリケーションの名前。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 255 です。 必須: はい  | 
|  **clientToken**  |  リクエストの冪等性のために割り当てる一意の識別子 (大文字と小文字を区別) を指定します。これにより、同じ操作を誤って 2 度実行することなく、リクエストを安全に再試行できます。操作の後半の呼び出しで同じ値を渡す場合は、他のすべてのパラメータにも同じ値を渡す必要があります。[UUID タイプの値](https://wikipedia.org/wiki/Universally_unique_identifier)を使用することが推奨されます。 この値を指定しない場合、 はランダムな値 AWS を生成します。 同じ `ClientToken` を使って、異なるパラメータで操作を再試行すると、再試行は `IdempotentParameterMismatch` のエラーにより失敗します。 タイプ: 文字列 パターン: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必須: いいえ  | 
|  **customerManagedKeyIdentifier**  |  によって カスタマー管理キー 生成された の ARN AWS Key Management Service。このキーはデータの暗号化に使用します。 キーが指定されていない場合は、 AWS マネージドキー が使用されます。リソースに割り当てるタグの、キーと値のペアのマップ。  AWS 所有のキー およびカスタマーマネージドキーの詳細については、「 *AWS Key Management Service デベロッパーガイド*」の[「カスタマーキーと AWS キー](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt)」を参照してください。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 1,011 です。 パターン: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必須: いいえ  | 
|  **[ Description]** ( 説明)  |  アプリケーションの説明です。 タイプ: 文字列 必須: はい  | 
|  **iconUrl**  |  AppClient のアイコンまたはロゴの URL です。 タイプ: 文字列 必須: いいえ  | 
|  **redirectUrls**  |  承認後にエンドユーザーがリダイレクトされる URI です。redirectUrls は 5 個まで追加できます。例えば、`https://localhost:8080`。 型: 文字列の配列 配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。 長さの制限：最小長 1、最大長は 2,048 です。 パターン: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` 必須: はい  | 
|  **starterUserEmails**  |  AppClient が検証されるまでインサイトを受け取ることが許可されている、ユーザーのためのスターターメールアドレス。 型: 文字列の配列 配列メンバー: 1 項目の定数です。 長さの制約: 最小長は 0 です。最大長は 320 です。 パターン: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` 必須: はい  | 
|  **[タグ]**  |  リソースに割り当てるタグの、キーと値のペアのマップ。 タイプ: タグオブジェクトの配列 配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。 必須: いいえ  | 

## レスポンス要素
<a name="API_CreateAppClient_response"></a>

アクションが成功すると、HTTP 201 レスポンスが返されます。

サービスから以下のデータが JSON 形式で返されます。


| パラメータ | 説明 | 
| --- | --- | 
|  **appClientSummary**  |  AppClient の概要が含まれています。 タイプ:[AppClientSummary](API_AppClientSummary.md) オブジェクト  | 

# DeleteAppClient
<a name="API_DeleteAppClient"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

アプリケーションクライアントを削除します。

**Topics**
+ [リクエストボディ](#API_DeleteAppClient_request)
+ [レスポンス要素](#API_DeleteAppClient_response)

## リクエストボディ
<a name="API_DeleteAppClient_request"></a>

リクエストは以下の JSON 形式のデータを受け入れます。


| パラメータ | 説明 | 
| --- | --- | 
|  **appClientIdentifier**  |  リクエストに使用する AppClient の Amazon リソースネーム (ARN) または Universal Unique Identifier (UUID) です。 長さの制限：最小長 1、最大長は 1,011 です。 パターン: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必須: はい  | 

## レスポンス要素
<a name="API_DeleteAppClient_response"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 204 レスポンスを返します。

# GetAppClient
<a name="API_GetAppClient"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

AppClient に関する情報を返します。

**Topics**
+ [リクエストボディ](#API_GetAppClient_request)
+ [レスポンス要素](#API_GetAppClient_response)

## リクエストボディ
<a name="API_GetAppClient_request"></a>

リクエストは以下の JSON 形式のデータを受け入れます。


| パラメータ | 説明 | 
| --- | --- | 
|  **appClientIdentifier**  |  リクエストに使用する AppClient の Amazon リソースネーム (ARN) または Universal Unique Identifier (UUID) です。 長さの制限：最小長 1、最大長は 1,011 です。 パターン: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必須: はい  | 

## レスポンス要素
<a name="API_GetAppClient_response"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。


| パラメータ | 説明 | 
| --- | --- | 
|  **appClient**  |  AppClient に関する情報が含まれます。 タイプ: [AppClient](API_AppClient.md) オブジェクト  | 

# ListActionableInsights
<a name="API_ListActionableInsights"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

実行可能な E メールメッセージ、タスク、その他の更新の最も重要なものを一覧表示します。

**Topics**
+ [リクエストボディ](#API_ListActionableInsights_request)
+ [レスポンス要素](#API_ListActionableInsights_response)

## リクエストボディ
<a name="API_ListActionableInsights_request"></a>

リクエストは以下の JSON 形式のデータを受け入れます。


| パラメータ | 説明 | 
| --- | --- | 
|  **nextToken**  |  `nextToken` が返された場合、その他にもまだ結果があります。`nextToken` の値は、各ページに固有のページネーショントークンです。後続ページを取得するには、返されたトークンを使用して再度呼び出します。他の引数をすべて維持します。各ページネーショントークンの有効期間は 24 時間です。期限の切れたページネーショントークンを使用すると、HTTP 400 InvalidToken エラーが返されます。  | 

## レスポンス要素
<a name="API_ListActionableInsights_response"></a>

アクションが成功すると、HTTP 201 レスポンスが返されます。

サービスから以下のデータが JSON 形式で返されます。


| パラメータ | 説明 | 
| --- | --- | 
|  **ActionableInsightsList**  |  件名、説明、アクション、作成済みのタイムスタンプなど実行可能なインサイトを一覧表示します。詳細については、「[ActionableInsights](API_ActionableInsights.md)」を参照してください。  | 
|  **nextToken**  |  `nextToken` が返された場合、その他にもまだ結果があります。`nextToken` の値は、各ページに固有のページネーショントークンです。後続ページを取得するには、返されたトークンを使用して再度呼び出します。他の引数をすべて維持します。各ページネーショントークンの有効期間は 24 時間です。期限の切れたページネーショントークンを使用すると、HTTP 400 InvalidToken エラーが返されます。 タイプ: 文字列  | 

# ListAppClients
<a name="API_ListAppClients"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

すべての AppClients のリストを返します。

**Topics**
+ [リクエストボディ](#API_ListAppClients_request)
+ [レスポンス要素](#API_ListAppClients_response)

## リクエストボディ
<a name="API_ListAppClients_request"></a>

リクエストは以下の JSON 形式のデータを受け入れます。


| パラメータ | 説明 | 
| --- | --- | 
|  **maxResults**  |  コールごとに返される結果の最大数です。`nextToken` を使用すると結果ページをさらに取得できます。 こちらはあくまでも上限です。1 回のコールで返される実際の結果が、指定の最大数より少なくなる場合もあります。 有効範囲: 最小値 1。最大値は 100 です。  | 
|  **nextToken**  |  `nextToken` が返された場合、その他にもまだ結果があります。`nextToken` の値は、各ページに固有のページネーショントークンです。後続ページを取得するには、返されたトークンを使用して再度呼び出します。他の引数をすべて維持します。各ページネーショントークンの有効期間は 24 時間です。期限の切れたページネーショントークンを使用すると、HTTP 400 InvalidToken エラーが返されます。  | 

## レスポンス要素
<a name="API_ListAppClients_response"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。


| パラメータ | 説明 | 
| --- | --- | 
|  **appClientList**  |  AppClient の結果のリストが含まれています。 タイプ: [AppClientSummary](API_AppClientSummary.md) オブジェクトの配列。  | 
|  **nextToken**  |  `nextToken` が返された場合、その他にもまだ結果があります。`nextToken` の値は、各ページに固有のページネーショントークンです。後続ページを取得するには、返されたトークンを使用して再度呼び出します。他の引数をすべて維持します。各ページネーショントークンの有効期間は 24 時間です。期限の切れたページネーショントークンを使用すると、HTTP 400 InvalidToken エラーが返されます。 タイプ: 文字列  | 

# ListMeetingInsights
<a name="API_ListMeetingInsights"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

実行可能なカレンダーイベントの最も重要なものを一覧表示します。

**Topics**
+ [リクエストボディ](#API_ListMeetingInsights_request)
+ [レスポンス要素](#API_ListMeetingInsights_response)

## リクエストボディ
<a name="API_ListMeetingInsights_request"></a>

リクエストは以下の JSON 形式のデータを受け入れます。


| パラメータ | 説明 | 
| --- | --- | 
|  **nextToken**  |  `nextToken` が返された場合、その他にもまだ結果があります。`nextToken` の値は、各ページに固有のページネーショントークンです。後続ページを取得するには、返されたトークンを使用して再度呼び出します。他の引数をすべて維持します。各ページネーショントークンの有効期間は 24 時間です。期限の切れたページネーショントークンを使用すると、HTTP 400 InvalidToken エラーが返されます。  | 

## レスポンス要素
<a name="API_ListMeetingInsights_response"></a>

アクションが成功すると、HTTP 201 レスポンスが返されます。

サービスから以下のデータが JSON 形式で返されます。


| パラメータ | 説明 | 
| --- | --- | 
|  **MeetingInsightList**  |  会議に関する実行可能なインサイトを一覧表示します。詳細については、「[MeetingInsights](API_MeetingInsights.md)」を参照してください。  | 
|  **nextToken**  |  `nextToken` が返された場合、その他にもまだ結果があります。`nextToken` の値は、各ページに固有のページネーショントークンです。後続ページを取得するには、返されたトークンを使用して再度呼び出します。他の引数をすべて維持します。各ページネーショントークンの有効期間は 24 時間です。期限の切れたページネーショントークンを使用すると、HTTP 400 InvalidToken エラーが返されます。 タイプ: 文字列  | 

# PutFeedback
<a name="API_PutFeedback"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

特定のインサイトまたはアクションに関するフィードバックを送ることをユーザーに許可します。

**Topics**
+ [リクエストボディ](#API_PutFeedback_request)
+ [レスポンス要素](#API_PutFeedback_response)

## リクエストボディ
<a name="API_PutFeedback_request"></a>

リクエストは以下の JSON 形式のデータを受け入れます。


| パラメータ | 説明 | 
| --- | --- | 
|  **id**  |  フィードバックの送信対象となるオブジェクトの ID です。InsightId か ActionId のいずれかになります。  | 
|  **feedbackFor**  |  フィードバックの送信対象となるインサイトのタイプです。 使用できる値: `ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION`  | 
|  **feedbackRating**  |  `1` から `5` までの評価です。値が大きいほど評価が高いことを意味します。  | 

## レスポンス要素
<a name="API_PutFeedback_response"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 201 レスポンスを返します。

# トークン
<a name="API_Token"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

AppClients が認可コードをアクセストークンと交換できるようにする情報が含まれます。

**Topics**
+ [リクエストボディ](#API_Token_request)
+ [レスポンス要素](#API_Token_response)

## リクエストボディ
<a name="API_Token_request"></a>

リクエストは以下の JSON 形式のデータを受け入れます。


| パラメータ | 説明 | 
| --- | --- | 
|  **コード**  |  認可エンドポイントから受信した認可コードです。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。 必須: いいえ  | 
|  **grant\$1type**  |  トークンの付与のタイプ。`authorization_code` または `refresh_token` である必要があります。 タイプ: 文字列 必須: はい  | 
|  **app\$1client\$1id**  |  AppClient の ID です。 タイプ: 文字列 パターン: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必須: はい  | 
|  **redirect\$1uri**  |  認可エンドポイントに渡されたリダイレクト URI。 タイプ: 文字列 必須: いいえ  | 
|  **refresh\$1token**  |  最初のトークンリクエストで受け取った更新トークンです。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 4,096 です。 必須: いいえ  | 

## レスポンス要素
<a name="API_Token_response"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。


| パラメータ | 説明 | 
| --- | --- | 
|  **appfabric\$1user\$1id**  |  トークン用のユーザーの ID。この値は、リクエストが `authorization_code` グラントタイプを使用している場合のみ返されます。 タイプ: 文字列  | 
|  **expires\$1in**  |  トークンの有効期限が切れるまでの残りの秒数。 タイプ: Long  | 
|  **refresh\$1token**  |  次のリクエストに使用する更新トークンです。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。  | 
|  **token** (トークン)  |  アクセストークンです。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。  | 
|  **token\$1type**  |  トークンのタイプです。 タイプ: 文字列  | 

# UpdateAppClient
<a name="API_UpdateAppClient"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

AppClient を更新します。

**Topics**
+ [リクエストボディ](#API_UpdateAppClient_request)
+ [レスポンス要素](#API_UpdateAppClient_response)

## リクエストボディ
<a name="API_UpdateAppClient_request"></a>

リクエストは以下の JSON 形式のデータを受け入れます。


| パラメータ | 説明 | 
| --- | --- | 
|  **appClientIdentifier**  |  リクエストに使用する AppClient の Amazon リソースネーム (ARN) または Universal Unique Identifier (UUID) です。 長さの制限：最小長 1、最大長は 1,011 です。 パターン: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必須: はい  | 
|  **redirectUrls**  |  承認後にエンドユーザーがリダイレクトされる URI です。redirectUrls は 5 個まで追加できます。例えば、`https://localhost:8080`。 型: 文字列の配列 配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。 長さの制限：最小長 1、最大長は 2,048 です。 パターン: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+`   | 

## レスポンス要素
<a name="API_UpdateAppClient_response"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。


| パラメータ | 説明 | 
| --- | --- | 
|  **appClient**  |  AppClient に関する情報が含まれます。 タイプ: [AppClient](API_AppClient.md) オブジェクト  | 

# AppFabric for productivity の API データ型 (プレビュー)
<a name="productivity-data-types"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

AppFabric API には、さまざまなアクションに使用される複数のデータ型が含まれています。このセクションでは、AppFabric for productivity 機能のデータ型について詳しく説明します。

AppFabric API のその他のデータ型については、「[AWS AppFabric API Data Types](https://docs.aws.amazon.com/appfabric/latest/api/API_Types.html)」を参照してください。

**重要**  
データ型構造内の各要素の順序は保証されません。アプリケーションは特定の順序を想定するべきではありません。

**Topics**
+ [ActionableInsights](API_ActionableInsights.md)
+ [AppClient](API_AppClient.md)
+ [AppClientSummary](API_AppClientSummary.md)
+ [MeetingInsights](API_MeetingInsights.md)
+ [VerificationDetails](API_VerificationDetails.md)

# ActionableInsights
<a name="API_ActionableInsights"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

アプリケーションポートフォリオの E メール、カレンダーの招待、メッセージ、タスクに基づく、ユーザーにとって重要かつ最も適したアクションの概要が含まれます。ユーザーは、すべてのアプリケーションを横断する先を見越したインサイトを確認でき、その日の最適な進め方を確認することができます。これらのインサイトを見れば、ユーザーが、インサイトのサマリーだけでなく、インサイトを生成した、各アプリケーションやアーティファクトなどの参照情報 (埋め込みリンクなど) にも目を向けるべき理由がわかります。


| パラメータ | 説明 | 
| --- | --- | 
|  **insightId**  |  生成されたインサイトの一意の ID です。  | 
|  **insightContent**  |  インサイトの概要と、インサイトの生成に使用されたアーティファクトへの埋め込みリンクを返します。 こちらは、埋め込みリンク (`<a>` タグ) を含む HTML コンテンツです。  | 
|  **insightTitle**  |  生成されたインサイトの件名です。  | 
|  **createdAt**  |  インサイトが生成された日時です。  | 
|  **actions**  |  生成されたインサイトで推奨されるアクションのリストです。 アクションオブジェクトには、以下のパラメータが含まれています。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/appfabric/latest/adminguide/API_ActionableInsights.html)  | 

# AppClient
<a name="API_AppClient"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

AppClient に関する情報が含まれます。

**Topics**


| パラメータ | 説明 | 
| --- | --- | 
|  **appName**  |  アプリケーションの名前。 タイプ: 文字列 必須: はい  | 
|  **arn**  |  AppClient の Amazon リソースネーム (ARN) です。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 1,011 です。 パターン: `arn:.+` 必須: はい  | 
|  **[ Description]** ( 説明)  |  アプリケーションの説明です。 タイプ: 文字列 必須: はい  | 
|  **iconUrl**  |  AppClient のアイコンまたはロゴの URL です。 タイプ: 文字列 必須: いいえ  | 
|  **redirectUrls**  |  AppClient で許可されているリダイレクト URL。 型: 文字列の配列 配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。 長さの制限：最小長 1、最大長は 2,048 です。 パターン: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` 必須: はい  | 
|  **starterUserEmails**  |  AppClient が検証されるまでインサイトを受け取ることが許可されている、ユーザーのためのスターターメールアドレス。 型: 文字列の配列 配列メンバー: 1 項目の定数です。 長さの制約: 最小長は 0 です。最大長は 320 です。 パターン: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` 必須: はい  | 
|  **verificationDetails**  |  AppClient 検証のステータスと理由が含まれます。 タイプ: [VerificationDetails](API_VerificationDetails.md) オブジェクト 必須: はい  | 
|  **customerManagedKeyArn**  |  AppClient AWS Key Management Service 用に によって生成された の カスタマー管理キー Amazon リソースネーム (ARN)。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 1,011 です。 パターン: `arn:.+` 必須: いいえ  | 
|  **appClientId**  |  AppClient の ID です。app-client の o-auth フローで使用される手段。 タイプ: 文字列 パターン: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必須: いいえ  | 

# AppClientSummary
<a name="API_AppClientSummary"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

AppClient に関する情報が含まれます。

**Topics**


| パラメータ | 説明 | 
| --- | --- | 
|  **arn**  |  AppClient の Amazon リソースネーム (ARN) です。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 1,011 です。 パターン: `arn:.+` 必須: はい  | 
|  **verificationStatus**  |  AppClient の検証ステータスです。 型: 文字列 有効な値：`pending_verification \| verified \| rejected` 必須: はい  | 
|  **appClientId**  |  AppClient の ID です。app-client の o-auth フローで使用される手段。 タイプ: 文字列 パターン: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必須: いいえ  | 

# MeetingInsights
<a name="API_MeetingInsights"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

上位 3 件の会議の概要と、会議の目的、関連するクロスアプリケーションアーティファクト、また、タスク、E メール、メッセージ、カレンダーイベントのアクティビティが含まれます。


| パラメータ | 説明 | 
| --- | --- | 
|  **insightId**  |  生成されたインサイトの一意の ID です。  | 
|  **insightContent**  |  インサイトの説明で、詳細が文字列の形式で強調表示されています。例えば、なぜこのインサイトが重要なのか、など。  | 
|  **insightTitle**  |  生成されたインサイトの件名です。  | 
|  **createdAt**  |  インサイトが生成された日時です。  | 
|  **calendarEvent**  |  ユーザーが注意すべき重要なカレンダーイベントまたは会議です。 カレンダーイベントオブジェクト: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/appfabric/latest/adminguide/API_MeetingInsights.html)  | 
|  **resources**  |  インサイトの生成に関連する他のリソースを含むリストです。 リソースオブジェクト: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/appfabric/latest/adminguide/API_MeetingInsights.html)  | 
|  **nextToken**  |  次回のインサイトのセットを取得するためのページネーショントークンです。こちらはオプションのフィールドで、null が返された場合は、ロードするインサイトがそれ以上ないことを意味します。  | 

# VerificationDetails
<a name="API_VerificationDetails"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

AppClient 検証のステータスと理由が含まれます。

**Topics**


| パラメータ | 説明 | 
| --- | --- | 
|  **verificationStatus**  |  AppClient の検証ステータスです。 型: 文字列 有効な値：`pending_verification \| verified \| rejected` 必須: はい  | 
|  **statusReason**  |  AppClient の検証ステータスの理由です。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 1,024 です。 必須: いいえ  | 

# AppFabric for productivity の一般的な API エラー (プレビュー)
<a name="productivity-common-errors"></a>


|  | 
| --- |
|  AWS AppFabric for productivity 機能はプレビュー版であり、変更される可能性があります。 | 

このセクションでは、 AWS AppFabric productivity 機能の API アクションに共通するエラーを一覧表示します。

AppFabric のその他の一般的な API エラーについては、「AWS AppFabric API Reference」の [AppFabric for productivity の AppClients AppClients のトラブルシューティング](ahead-app-dev-errors.md) および「[AWS AppFabric API common errors](https://docs.aws.amazon.com/appfabric/latest/api/CommonErrors.html)」を参照してください。


| 例外名 | 説明 | 
| --- | --- | 
|  **TokenException**  |  トークンリクエストは無効です。 HTTP ステータスコード: 400  |