> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# InitialUploadRequest (JSON)

> InitialUploadRequest (JSON)

# InitialUploadRequest (JSON)

POST GameClip 업로드 요청의 본문입니다.

## InitialUploadRequest

InitialUploadRequest 개체는 다음 사양을 가집니다.

| 멤버 | 형식 | 설명 |
| - | - | - |
| **greatestMomentId** | string | 클립의 이름으로 사용할 텍스트에 대한 문자열 ID입니다. 이 값은 타이틀 개발자가 타이틀의 구성 파일에서 관리 및 지역화합니다. |
| **userCaption** | string | 선택 사항입니다. 게임 클립에 대해 사용자가 입력한 대체 이름으로, 최대 길이는 250자입니다. |
| **sessionRef** | string | 선택 사항입니다. 녹화가 이루어진 게임 세션 참조입니다. |
| **dateRecorded** | DateTime | 녹화가 시작된 시간(UTC)입니다. ISO 8601 형식의 문자열로 마샬링됩니다(자세한 내용은 [Date and Time Formats](https://www.w3.org/TR/NOTE-datetime) 참조). |
| **durationInSeconds** | 32비트 부호 없는 정수 | 클립의 길이(초)입니다. |
| **expectedBlocks** | 32비트 부호 없는 정수 | 선택 사항입니다. 파일이 분할될 블록의 수입니다. 파일이 단일 요청으로 전송되는 경우 생략합니다. |
| **fileSize** | 32비트 부호 없는 정수 | 업로드될 비디오의 파일 크기(바이트)입니다. |
| **type** | [GameClipType 열거형](/ko/reference/live/rest/enums/gvr-enum-gamecliptypes.md) | 클립의 유형으로, 쉼표로 구분된 열거형의 문자열 값으로 마샬링됩니다. |
| **source** | [GameClipSource 열거형](/ko/reference/live/rest/enums/gvr-enum-gameclipsource.md) | 클립이 소스된 방법을 지정하며, 열거형의 문자열 값으로 마샬링됩니다. |
| **visibility** | [GameClipVisibility 열거형](/ko/reference/live/rest/enums/gvr-enum-gameclipvisibility.md) | 시스템에 게시된 후의 게임 클립의 표시 여부를 지정합니다. |
| **titleData** | string | 선택 사항입니다. 이 클립과 관련된 타이틀별 속성에 대한 속성 백입니다. 있는 그대로 저장 및 반환됩니다. 타이틀 개발자는 이 필드를 사용하여 클립에 대한 자체 메타데이터를 지속할 수 있습니다. |
| **titleData** | string | 선택 사항입니다. 이 클립과 관련된 콘솔별 속성에 대한 속성 백입니다. 있는 그대로 저장 및 반환됩니다. 콘솔 플랫폼은 이 필드를 사용하여 클립에 대한 자체 메타데이터를 지속할 수 있습니다. |
| **systemProperties** | string | 선택 사항입니다. 이 클립과 관련된 콘솔별 속성에 대한 속성 백입니다. 있는 그대로 저장 및 반환됩니다. 콘솔 플랫폼은 이 필드를 사용하여 클립에 대한 자체 메타데이터를 지속할 수 있습니다. |
| **usersInSession** | string 배열 | 선택 사항입니다. 현재 세션의 사용자 목록입니다. |
| **thumbnailSource** | [ThumbnailSource 열거형](/ko/reference/live/rest/enums/gvr-enum-thumbnailsource.md) | 선택 사항입니다. 썸네일의 소스입니다. |
| **thumbnailOffsetMillseconds** | 32비트 부호 있는 정수 | 오프셋으로 생성된 썸네일의 오프셋(밀리초)을 지정합니다. **thumbnailSource**가 Offset으로 설정된 경우에만 지정됩니다. |
| **savedByUser** | 부울 값 | 선택 사항입니다. 클립을 FIFO 저장소 대신 사용자의 할당량에 저장되도록 설정합니다. 기본값은 false입니다. |

## 샘플 JSON 구문

```json theme={null}
{
   "greatestMomentId": "123abc",
   "userCaption": "OMG Look at this!",
   "sessionRef": "4587552a-a5ad-4c4c-a787-5bc5af70e4c9",
   "dateRecorded": "2012-12-23T11:08:08Z",
   "durationInSeconds": 27,
   "expectedBlocks": 7,
   "fileSize": 1234567,
   "type": "MagicMoment, Achievement",
   "source": "Console",
   "visibility": "Default",
   "titleData": "{ 'Boss': 'The Invincible' }",
   "systemProperties": "{ 'Id': '123456', 'Location': 'C:\\videos\\123456.mp4' }",
   "thumbnailSource": "Offset",
   "thumbnailOffsetMillseconds": 20000,
   "savedByUser": false
 }
    
```

## 함께 보기

##### 상위

[JSON(JavaScript Object Notation) 개체 참조](/ko/reference/live/rest/json/atoc-xboxlivews-reference-json)


## Related topics

- [ThumbnailSource Enumeration](/reference/live/rest/enums/gvr-enum-thumbnailsource.md)
- [Enumeração ThumbnailSource](/pt-BR/reference/live/rest/enums/gvr-enum-thumbnailsource.md)
- [ThumbnailSource 列舉](/zh-TW/reference/live/rest/enums/gvr-enum-thumbnailsource.md)
- [Enumeración ThumbnailSource](/es/reference/live/rest/enums/gvr-enum-thumbnailsource.md)
- [ThumbnailSource 枚举](/zh-CN/reference/live/rest/enums/gvr-enum-thumbnailsource.md)