기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 생산성을 위한 AppFabric APIs(미리 보기)
<a name="productivity-apis"></a>


|  | 
| --- |
| 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 

이 섹션에서는 AWS AppFabric 생산성 기능에 대한 API 작업, 데이터 유형 및 일반적인 오류를 제공합니다.

**참고**  
다른 모든 AppFabric API에 대해서는 [AWS AppFabric API 참조](https://docs.aws.amazon.com/appfabric/latest/api/)를 참조하세요.

**Topics**
+ [생산성을 위한 AppFabric API 작업(미리 보기)](productivity-actions.md)
+ [생산성을 위한 AppFabric의 API 데이터 형식(미리 보기)](productivity-data-types.md)
+ [생산성을 위한 AppFabric의 일반적인 API 오류(미리 보기)](productivity-common-errors.md)

# 생산성을 위한 AppFabric API 작업(미리 보기)
<a name="productivity-actions"></a>


|  | 
| --- |
| 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 

생산성을 위한 AppFabric 기능에는 다음 작업이 지원됩니다.

다른 모든 AppFabric API 작업에 대해서는 [AWS AppFabric API 작업](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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

AppClient를 생성합니다.

**Topics**
+ [요청 본문](#API_CreateAppClient_request)
+ [응답 요소](#API_CreateAppClient_response)

## 요청 본문
<a name="API_CreateAppClient_request"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.


| 파라미터 | 설명 | 
| --- | --- | 
|  **appName**  |  앱의 이름입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 255입니다. 필수 항목 여부: 예  | 
|  **clientToken**  |  요청 멱등성을 보장하기 위해 제공하는 고유한 대/소문자 구분 식별자를 지정합니다. 이렇게 하면 실수로 같은 작업을 두 번 수행하지 않고 요청을 안전하게 재시도할 수 있습니다. 나중에 작업을 호출할 때 동일한 값을 전달하려면 다른 모든 파라미터에도 동일한 값을 전달해야 합니다. [UUID 유형의 값](https://wikipedia.org/wiki/Universally_unique_identifier)을 사용하는 것이 좋습니다. 이 값을 제공하지 않으면가 임의의 값을 AWS 생성합니다. 다른 파라미터를 사용하여 `ClientToken`과 같은 작업을 재시도하면 `IdempotentParameterMismatch` 오류가 발생하며 재시도가 실패합니다. 유형: String 패턴: `[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입니다. redirectUrl을 최대 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-]+)*` 필수 여부: 예  | 
|  **tags**  |  리소스에 할당할 태그의 키-값 페어 맵입니다. 유형: 태그 객체 배열 배열 구성원: 최소수는 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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

애플리케이션 클라이언트를 삭제합니다.

**Topics**
+ [요청 본문](#API_DeleteAppClient_request)
+ [응답 요소](#API_DeleteAppClient_response)

## 요청 본문
<a name="API_DeleteAppClient_request"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.


| 파라미터 | 설명 | 
| --- | --- | 
|  **appClientIdentifier**  |  요청에 사용할 AppClient의 Amazon 리소스 이름(ARN) 또는 범용 고유 식별자(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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

AppClient에 대한 정보를 반환합니다.

**Topics**
+ [요청 본문](#API_GetAppClient_request)
+ [응답 요소](#API_GetAppClient_response)

## 요청 본문
<a name="API_GetAppClient_request"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.


| 파라미터 | 설명 | 
| --- | --- | 
|  **appClientIdentifier**  |  요청에 사용할 AppClient의 Amazon 리소스 이름(ARN) 또는 범용 고유 식별자(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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

가장 중요한 실행 가능 이메일 메시지, 작업 및 기타 업데이트를 나열합니다.

**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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

모든 AppClient의 목록을 반환합니다.

**Topics**
+ [요청 본문](#API_ListAppClients_request)
+ [응답 요소](#API_ListAppClients_response)

## 요청 본문
<a name="API_ListAppClients_request"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.


| 파라미터 | 설명 | 
| --- | --- | 
|  **maxResults**  |  호출 한 개당 반환되는 결과의 최대 수입니다. `nextToken`을 사용하여 추가 결과 페이지를 얻을 수 있습니다. 이는 상한선일 뿐입니다. 호출당 반환되는 실제 결과 수는 지정된 최대값보다 적을 수 있습니다. 유효 범위: 최소값 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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

가장 중요한 실행 가능 캘린더 이벤트를 나열합니다.

**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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

사용자가 주어진 인사이트나 작업에 대한 피드백을 제출할 수 있습니다.

**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`\$1`5` 평점이 높을수록 좋습니다.  | 

## 응답 요소
<a name="API_PutFeedback_response"></a>

작업이 성공하면 서비스가 비어있는 HTTP 본문과 함께 HTTP 201 응답을 다시 전송합니다.

# 토큰
<a name="API_Token"></a>


|  | 
| --- |
| 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 

AppClient가 인증 코드를 액세스 토큰으로 교환할 수 있도록 허용하는 정보를 포함합니다.

**Topics**
+ [요청 본문](#API_Token_request)
+ [응답 요소](#API_Token_response)

## 요청 본문
<a name="API_Token_request"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.


| 파라미터 | 설명 | 
| --- | --- | 
|  **code**  |  인증 엔드포인트에서 받은 인증 코드입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요  | 
|  **grant\$1type**  |  토큰의 권한 부여 유형입니다. `authorization_code` 또는 `refresh_token`여야 합니다. 유형: 문자열 필수 항목 여부: 예  | 
|  **app\$1client\$1id**  |  AppClient의 ID입니다. 유형: String 패턴: `[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. 최대 길이 4096. 필수 여부: 아니요  | 

## 응답 요소
<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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

AppClient를 업데이트합니다.

**Topics**
+ [요청 본문](#API_UpdateAppClient_request)
+ [응답 요소](#API_UpdateAppClient_response)

## 요청 본문
<a name="API_UpdateAppClient_request"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.


| 파라미터 | 설명 | 
| --- | --- | 
|  **appClientIdentifier**  |  요청에 사용할 AppClient의 Amazon 리소스 이름(ARN) 또는 범용 고유 식별자(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입니다. redirectUrl을 최대 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의 API 데이터 형식(미리 보기)
<a name="productivity-data-types"></a>


|  | 
| --- |
| 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 

AppFabric API에는 다양한 작업에 사용되는 여러 데이터 유형이 포함되어 있습니다. 이 섹션에서는 생산성을 위한 AppFabric 기능의 데이터 유형에 대해 자세히 설명합니다.

다른 모든 AppFabric API 데이터 유형에 대해서는 [AWS AppFabric API 데이터 유형](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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

앱 포트폴리오의 이메일, 캘린더 초대, 메시지 및 작업을 기반으로 사용자에게 필요하고 중요하며 적합한 작업을 요약하여 제공합니다. 사용자는 애플리케이션 전반에서 하루의 방향을 가장 잘 잡을 수 있도록 돕는 사전 예방형 인사이트를 확인할 수 있습니다. 이 인사이트는 사용자가 인사이트를 생성한 개별 앱 및 아티팩트에 대한 참조(예: 포함된 링크)와 함께 인사이트 요약에 관심을 가져야 하는 이유에 대한 근거가 됩니다.


| 파라미터 | 설명 | 
| --- | --- | 
|  **insightId**  |  생성된 인사이트의 고유 ID입니다.  | 
|  **insightContent**  |  이렇게 하면 인사이트 요약과 인사이트 생성에 사용된 아티팩트에 대한 포함된 링크가 반환됩니다. 이는 포함된 링크(`<a>` 태그)가 포함된 HTML 콘텐츠입니다.  | 
|  **insightTitle**  |  생성된 인사이트의 제목입니다.  | 
|  **createdAt**  |  인사이트가 생성된 시점입니다.  | 
|  **actions**  |  생성된 인사이트에 대한 권장 작업 목록입니다. 작업 객체는 다음 파라미터를 포함합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/API_ActionableInsights.html)  | 

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


|  | 
| --- |
| 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 

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입니다. 앱 클라이언트의 인증 흐름에 사용됩니다. 유형: String 패턴: `[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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

AppClient에 대한 정보가 들어 있습니다.

**Topics**


| 파라미터 | 설명 | 
| --- | --- | 
|  **arn**  |  AppClient의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1,011입니다. 패턴: `arn:.+` 필수 여부: 예  | 
|  **verificationStatus**  |  AppClient 확인 상태입니다. 타입: 문자열 유효 값: `pending_verification \| verified \| rejected` 필수 사항 여부: 예  | 
|  **appClientId**  |  AppClient의 ID입니다. 앱 클라이언트의 인증 흐름에 사용됩니다. 유형: String 패턴: `[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 기능은 미리 보기 중이며 변경될 수 있습니다. | 

회의 목적, 관련 앱 간 아티팩트, 작업 활동, 이메일에서의 활동, 메시지에서의 활동, 캘린더 이벤트에서의 활동과 함께 상위 3개 미팅에 대한 요약이 포함되어 있습니다.


| 파라미터 | 설명 | 
| --- | --- | 
|  **insightId**  |  생성된 인사이트의 고유 ID입니다.  | 
|  **insightContent**  |  세부 정보를 문자열 형식으로 강조 표시하는 인사이트에 대한 설명입니다. 즉, 이 인사이트가 왜 중요한지에 대한 것입니다.  | 
|  **insightTitle**  |  생성된 인사이트의 제목입니다.  | 
|  **createdAt**  |  인사이트가 생성된 시점입니다.  | 
|  **calendarEvent**  |  사용자가 집중해야 하는 중요한 캘린더 이벤트 또는 회의입니다. 캘린더 이벤트 객체: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/API_MeetingInsights.html)  | 
|  **resources**  |  인사이트 생성과 관련된 다른 리소스가 포함된 목록입니다. 리소스 객체: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/appfabric/latest/adminguide/API_MeetingInsights.html)  | 
|  **nextToken**  |  다음 인사이트 세트를 가져오기 위한 페이지 매김 토큰입니다. 이 필드는 선택 사항 필드이며, null을 반환하면 로드할 인사이트가 더 이상 없음을 의미합니다.  | 

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


|  | 
| --- |
| 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 

AppClient 확인의 상태 및 이유를 포함합니다.

**Topics**


| 파라미터 | 설명 | 
| --- | --- | 
|  **verificationStatus**  |  AppClient 확인 상태입니다. 타입: 문자열 유효 값: `pending_verification \| verified \| rejected` 필수 사항 여부: 예  | 
|  **statusReason**  |  AppClient 확인 상태 이유입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 1024. 필수 여부: 아니요  | 

# 생산성을 위한 AppFabric의 일반적인 API 오류(미리 보기)
<a name="productivity-common-errors"></a>


|  | 
| --- |
| 생산성을 위한 AWS AppFabric 기능은 미리 보기 중이며 변경될 수 있습니다. | 

이 섹션에서는 AWS AppFabric 생산성 기능의 API 작업에 공통적인 오류를 나열합니다.

다른 모든 AppFabric 일반 API 오류에 대해서는 [생산성을 위한 AppFabric AppClients 문제 해결](ahead-app-dev-errors.md) 및AWS AppFabric API 참조의 [AWS AppFabric API 일반 오류](https://docs.aws.amazon.com/appfabric/latest/api/CommonErrors.html)를 참조하세요.


| 예외 이름 | 설명 | 
| --- | --- | 
|  **TokenException**  |  토큰 요청이 유효하지 않습니다. HTTP 상태 코드: 400  |