Como o merge-patch funciona

PATCH /v1/videos/{id} aceita a configuração inteira do player, mas raramente você altera tudo de uma vez. O corpo é um merge-patch: envie só o que você quer alterar. Qualquer grupo que você omitir — e qualquer chave que você omitir dentro de um grupo — mantém o valor salvo. Então, mudar um único interruptor é um corpo de uma chave só:

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

Todos os outros controles, e todos os outros recursos, ficam intactos. Isso funciona do mesmo jeito para todo grupo de recursos — cada guia por recurso desta seção mostra um exemplo focado.

Coleções

call_actions e pixels.items são coleções, e o merge funciona por item: um item com um id altera essa entrada, um item sem ele cria uma entrada nova, e um item com "_destroy": true a exclui. As entradas que você não mencionar ficam como estão.

Arrays de valores

Listas simples de valores — como traffic_filter.countries — substituem a lista salva em vez de se mesclarem com ela. Sempre envie a lista completa que você quer.

Chaves somente leitura

Algumas chaves aparecem no GET, mas pertencem à plataforma — estado de experimento, cores derivadas, o arquivo da faixa de legenda. Se você enviá-las em um patch, elas são ignoradas em silêncio, não rejeitadas; cada guia de recurso indica quais são.