Intelligent Media Management:GenerateWebofficeToken

• Antes de usar esta operação, certifique-se de estar familiarizado com a cobrança do Intelligent Media Management. Para mais informações, consulte Preços.

• Não realize acesso transfronteiriço a arquivos do OSS. Por exemplo, se um arquivo estiver armazenado em um bucket na região de Cingapura, não inicie solicitações de visualização, leitura ou download a partir da China continental. Nesses cenários, a qualidade do link de rede é significativamente afetada pelo ambiente de rede transfronteiriço, o que pode causar aumento na latência de acesso, falhas de visualização, interrupções de download ou conexões instáveis. A estabilidade da rede e a experiência de acesso não podem ser garantidas. Certifique-se de que o ponto de acesso e o bucket estejam na mesma região para evitar incertezas causadas pelo acesso transfronteiriço.

• A credencial de acesso expira em 30 minutos e a credencial de atualização expira em 1 dia.

• O tempo de expiração retornado está em UTC, que está 8 horas atrás do UTC+8.

• Formatos de arquivo de entrada suportados:

  • Documentos do Word: doc, docx, txt, dot, wps, wpt, dotx, docm, dotm e rtf.

  • Documentos de apresentação (PPT): ppt, pptx, pptm, ppsx, ppsm, pps, potx, potm, dpt e dps.

  • Documentos do Excel: et, xls, xlt, xlsx, xlsm, xltx, xltm e csv.

  • Documentos PDF: pdf.

• O tamanho máximo de arquivo suportado é de 200 MB.

• O número máximo de páginas de documento suportado é 5.000.

• Para projetos criados antes de 1º de dezembro de 2023, a cobrança é baseada no número de aberturas de documentos. Atualmente, a cobrança é baseada no número de chamadas de API. Para mudar para o novo modo de cobrança, crie um novo projeto. Observe que cada chamada de API pode ser usada por apenas um usuário. Se a chamada for reutilizada, apenas o último usuário poderá acessar o documento normalmente, e as permissões de acesso de outros usuários serão revogadas.

• Ative o Message Service (MNS) na mesma região do Intelligent Media Management, crie um tópico e uma fila e configure uma assinatura. Você pode passar o nome do tópico MNS usando o parâmetro NotifyTopicName para receber notificações de mensagens sobre salvamentos de arquivos. Para mais informações sobre o SDK do MNS, consulte Receber e excluir mensagens. Para um exemplo do formato JSON do campo Message nas notificações de mensagens de salvamento de arquivos, consulte Formato de notificação de mensagens do WebOffice.

Exemplos de cenários típicos

Os exemplos a seguir descrevem alguns cenários típicos com base na estrutura de parâmetros:

Visualizar um arquivo somente leitura (obrigatório para visualização de arquivos PDF)

Modo de visualização de documento. O documento só pode ser visualizado e não pode ser editado:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.pdf",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

Visualizar um arquivo com extensão de nome de arquivo em maiúsculas

Para visualizar um arquivo com extensão de nome de arquivo em maiúsculas, defina o parâmetro Filename com uma extensão em minúsculas:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.DOCX",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

Visualizar apenas as 5 primeiras páginas de um documento

O documento tem 10 páginas no total. Apenas as 5 primeiras páginas são exibidas:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

Definir uma senha para visualização de documento

Defina uma senha para visualização de documento ou abra diretamente um arquivo de origem protegido por senha sem exigir uma senha:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Password" : "123456",
    "Permission" : "{'Readonly':'true'}"
}

Adicionar uma marca d'água à visualização de documento

Adicione uma marca d'água ao visualizar um documento:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Watermark" : "{'Type':'1','Value':'水印值','Font':'bold 20px Serif'}",
    "Permission" : "{'Readonly':'true'}"
}

Ocultar a barra de ferramentas durante a visualização do documento

Oculte a barra de ferramentas ao visualizar um documento:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Hidecmb" : "true",
    "Permission" : "{'Readonly':'true'}"
}

Editar um documento online com permissões para visualizar versões históricas, copiar, imprimir e exportar para PDF

Edite um documento online com permissões para visualizar versões históricas, copiar, imprimir e exportar para PDF:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Permission" : "{'Readonly':'false','History':'true','Copy':'true','Print':'true','Export':'true'}"
}
```.

Erros comuns.

O projeto especificado por ProjectName não foi encontrado. Acesse o console do IMM e verifique se o projeto existe na região.

{
    "Code": "ResourceNotFound",
    "Message": "The specified resource acs:imm::xxx:project/xxx is not found"
}
```.

O parâmetro User é obrigatório. Verifique se este parâmetro foi especificado.

{ "Code": "InvalidArgument.User", "Message": "The parameter User is required but not provided" }

O parâmetro User é inválido. Verifique se o valor do parâmetro está no formato JSON válido.

{ "Code": "InvalidJSON parsing error, User", "Message": "Specified parameter JSON parsing error, User is not valid." }

O parâmetro Permission é inválido. Verifique se o valor do parâmetro está no formato JSON válido.

{ "Code": "InvalidJSON parsing error, Permission", "Message": "Specified parameter JSON parsing error, Permission is not valid." }

O parâmetro Watermark é inválido. Verifique se o valor do parâmetro está no formato JSON válido.

{ "Code": "InvalidJSON parsing error, Watermark", "Message": "Specified parameter JSON parsing error, Watermark is not valid." }

O formato do parâmetro PreviewPages é inválido. Verifique o valor do parâmetro PreviewPages.

{ "Code": "InvalidPreviewPages", "Message": "Specified parameter PreviewPages is not valid." }

O arquivo do OSS especificado por SourceURI não existe. Verifique se o arquivo existe no bucket.

{ "Code": "ResourceNotFound", "Message": "The specified resource oss://xx is not found" }