Atualização dos dados de uma transmissão preexistente

Para o uso desse endpoint é necessário que suas credenciais de acesso tenham permissão para o uso do OAuth 2.0 para autorização.

POST https://eduplay.rnp.br/services/transmission/update/{identifierOrigin}

Path Parameters

Name	Type	Description
identifierOrigin*	String	identificador único do vídeo no sistema de origem

Query Parameters

Name	Type	Description
removeThumbnail	Boolean	definir se a miniatura existente deve ser removida, no caso de não ser enviado outro arquivo de miniatura. Se o parâmetro for definido como false e não for enviado o arquivo de miniatura, o anterior (caso exista) será mantido.
generateVoD	Boolean	definir se é para gerar um vídeo sob demanda a partir da transmissão. IMPORTANTE: caso já existe um vídeo sob demanda associado a transmissão, o mesmo será substituído pelo novo arquivo gerado. Caso não seja passado o parâmetro, o valor padrão é false.
changeAssociation	Boolean	flag para definir se é para alterar as associações entre a transmissão e os canais. Se definido como true TODAS as associações existentes e novas (caso desejado), devem ser enviadas juntamente com a transmissão. As associações que NÃO forem enviadas SERÃO removidas.

Request Body

Name	Type	Description
transmission*	transmissionMetadata	parâmetro do tipo multipart com as informações da transmissão a ser salva, conforme formato do tipo transmissionMetadata, definido na descrição dos serviços em api-docs.
thumbnail	binary	parâmetro do tipo multipart: arquivo com a imagem da transmissão (screenshot). Deve conter no cabeçalho o Content-Disposition com o respectivo filename.

200: OK

<returnMessage>
	<operationCode>CODIGO_DA_OPERACAO_DE_SUCESSO_OU_ERRO</operationCode>
	<message>MENSAGEM_EXPLICATIVA</message>
	<result>{"id":ID_TRANSMISSAO,"status":"ACTIVE|PENDING_APPROVAL","message":"MOTIVO DE ENVIO PARA MODERACAO"}</result> <!-- em caso de sucesso -->
	<result>DETALHES_ERRO</result> <!-- em caso de erro e existam detalhes necessários -->
</returnMessage>

403: Forbidden

503: Service Unavailable

500: Internal Server Error

412: Precondition Failed

401: Unauthorized

Considerações sobre os metadados para a atualização da transmissão:

• As informações obrigatórias são: title, description, audienceExpected, transmissionRate e schedules (pelo menos um).

• É possível definir controle de acesso por geolocalização (geoblocking) por meio do atributo geolocationControl com os valores possíveis: NONE e BRAZIL, para definir acesso sem geoblocking ou apenas em território brasileiro, respectivamente.

• É possível definir as seguintes opções de visibilidade:

  • PUBLIC - acesso público tanto pelo eduplay como por embed

  • PUBLIC_REFERENCED - acesso apenas por embed. O vídeo não será listado nas páginas e nem retornado na busca no eduplay

  • PRIVATE - acesso apenas a usuários autenticados no eduplay. É possível também permitir o acesso aos usuários não-autenticados por meio da definição de uma senha específica para esse fim no atributo password.

  • PRIVATE_RESTRICT_BY_PASSWORD - acesso restrito por senha específica para o conteúdo. Ao definir esse tipo de acesso, é obrigatório o envio da senha no atributo password.

  • PRIVATE_RESTRICT_BY_CHANNEL - acesso restrito apenas aos membros dos canais associados ao conteúdo.

• É possível definir uma lista de canais aos quais a transmissão deve ser associada, por meio do elemento channels. Os canais devem já existir no eduplay e o usuário em nome do qual está sendo publicado o conteúdo deve ser dono ou membro com permissão para publicação no mesmo. Para saber em quais canais o usuário pode publicar utilizar o endpoint Canais que um usuário pode publicar. Exemplo de definição do elemento channels em formato XML:

  <channels>
  	<channel><id>123</id></channel>
  	<channel><id>345</id></channel>
  </channels>