Atualização dos dados de uma transmissão preexistente (id do eduplay)

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.

PUT https://eduplay.rnp.br/services/transmission/{idTransmission}

Path Parameters

NameTypeDescription

idTransmission*

Long

identificador único da transmissão no eduplay

Query Parameters

NameTypeDescription

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

NameTypeDescription

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.

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

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>

Last updated