> ## 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)

El cuerpo de una solicitud POST de carga de GameClip.

## InitialUploadRequest

El objeto InitialUploadRequest tiene la siguiente especificación.

| Miembro | Tipo | Descripción |
| - | - | - |
| **greatestMomentId** | string | El identificador de cadena del texto que se usará como nombre del clip. El desarrollador del título lo administra y localiza en el archivo de configuración del título. |
| **userCaption** | string | Opcional. Nombre alternativo introducido por el usuario para el clip de juego, con una longitud máxima de 250 caracteres. |
| **sessionRef** | string | Opcional. Referencia de la sesión de juego durante la cual se realizó la grabación. |
| **dateRecorded** | DateTime | La hora en que se inició la grabación, en UTC. Serializada como una cadena en formato ISO 8601 (consulte [Date and Time Formats](https://www.w3.org/TR/NOTE-datetime) para obtener más información). |
| **durationInSeconds** | entero sin signo de 32 bits | La longitud del clip en segundos. |
| **expectedBlocks** | entero sin signo de 32 bits | Opcional. Número de bloques en los que se dividirá el archivo. Omítalo si el archivo se transmitirá en una única solicitud. |
| **fileSize** | entero sin signo de 32 bits | Tamaño de archivo en bytes del vídeo que se cargará. |
| **type** | [Enumeración GameClipType](/es/reference/live/rest/enums/gvr-enum-gamecliptypes) | El tipo de clip, serializado como un valor de cadena de la enumeración delimitado por comas. |
| **source** | [Enumeración GameClipSource](/es/reference/live/rest/enums/gvr-enum-gameclipsource) | Especifica cómo se originó el clip, serializado como un valor de cadena de la enumeración. |
| **visibility** | [Enumeración GameClipVisibility](/es/reference/live/rest/enums/gvr-enum-gameclipvisibility) | Especifica la visibilidad del clip de juego una vez publicado en el sistema. |
| **titleData** | string | Opcional. Contenedor de propiedades para las propiedades específicas del título asociadas a este clip. Se almacena y se devuelve tal cual. Los desarrolladores de títulos pueden usar este campo para conservar sus propios metadatos sobre un clip. |
| **titleData** | string | Opcional. Contenedor de propiedades para las propiedades específicas de la consola asociadas a este clip. Se almacena y se devuelve tal cual. La plataforma de la consola puede usar este campo para conservar sus propios metadatos sobre un clip. |
| **systemProperties** | string | Opcional. Contenedor de propiedades para las propiedades específicas de la consola asociadas a este clip. Se almacena y se devuelve tal cual. La plataforma de la consola puede usar este campo para conservar sus propios metadatos sobre un clip. |
| **usersInSession** | matriz de string | Opcional. Una lista de los usuarios de la sesión actual. |
| **thumbnailSource** | [Enumeración ThumbnailSource](/es/reference/live/rest/enums/gvr-enum-thumbnailsource) | Opcional. El origen de la miniatura. |
| **thumbnailOffsetMillseconds** | entero con signo de 32 bits | Especifica el desplazamiento (en milisegundos) para las miniaturas generadas por desplazamiento. Solo se especifica cuando **thumbnailSource** está establecido en Offset. |
| **savedByUser** | valor booleano | Opcional. Establece que el clip se guarde en la cuota del usuario en lugar del almacenamiento FIFO. El valor predeterminado es false. |

## Sintaxis JSON de ejemplo

```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
 }
    
```

## Consulte también

##### Elemento primario

[Referencia de objetos de notación de objetos JavaScript (JSON)](/es/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)