Cómo funciona el merge-patch

PATCH /v1/videos/{id} acepta toda la configuración del reproductor, pero rara vez la cambias toda a la vez. El cuerpo es un merge-patch: envía solo lo que quieres cambiar. Cualquier grupo que omitas — y cualquier clave que omitas dentro de un grupo — conserva su valor guardado. Así que activar o desactivar un interruptor es un cuerpo con una sola clave:

{
  "controls": {
    "seekbar": false
  }
}

Los demás controles, y las demás funcionalidades, no se modifican. Esto funciona igual para todos los grupos de funcionalidades — cada guía por funcionalidad de esta sección muestra un ejemplo específico.

Colecciones

call_actions y pixels.items son colecciones, y la combinación funciona por elemento: un elemento con un id modifica esa entrada, un elemento sin él crea una entrada nueva, y un elemento con "_destroy": true la elimina. Las entradas que no mencionas se quedan como están.

Arrays de valores

Las listas de valores simples — como traffic_filter.countries — reemplazan la lista guardada en lugar de combinarse con ella. Envía siempre la lista completa que quieres.

Campos hoja de solo lectura

Algunas claves aparecen en GET pero pertenecen a la plataforma — el estado del experimento, los colores derivados, el archivo de la pista de subtítulos. Si las envías en un patch, se ignoran sin aviso, no se rechazan; cada guía de funcionalidad indica cuáles son.