Online file editing - Drive and Photo Service - Drive and Photo Service: Central de Documentação do Alibaba Cloud

Edite arquivos do Office diretamente no navegador. Integre a edição online ao seu aplicativo usando as APIs do Drive and Photo Service.

Observações de uso

A edição online de arquivos é um serviço de valor agregado, desativado por padrão. Entre em contato conosco para ativá-lo. Para obter informações sobre preços, consulte Itens faturáveis de valor agregado.

Formatos de arquivo compatíveis:

Planilha	Documento de texto	Apresentação
ET, XLS, XLT, XLSX, XLSM, XLTX, XLTM, CSV	DOC, DOCX, TXT, DOT, WPS, WPT, DOTX, DOCM, DOTM, RTF	PPT, PPTX, PPTM, PPSX, PPSM, PPS, POTX, POTM, DPT, DPS

Até 365 usuários podem editar um arquivo simultaneamente. O desempenho pode diminuir com mais de 50 usuários simultâneos.
Tamanho máximo do arquivo: 200 MB.
O histórico de colaboração fica disponível por 180 dias.

Fluxo de trabalho da API e código de exemplo

1. Fluxo de trabalho da API

workflow

Nota:

Chame a API para obter a URL de edição e o token e abra a página de edição.
Os tokens expiram após um período definido. Chame a API de atualização com office_refresh_token para obter um novo token.
Acesse a página de edição usando tecnologia frontend. Use o SDK for JavaScript fornecido pelo Drive and Photo Service. Para obter mais informações, consulte os métodos getOfficeEditUrl e refreshOfficeEditToken na documentação do SDK for JavaScript.

2. Obter uma URL de edição online

POST /v2/file/get_office_edit_url

Parâmetros da solicitação

Parâmetro	Posição	Tipo	Obrigatório	Descrição
Authorization	header	String		Token de acesso.
x-share-token	header	String		Token de compartilhamento para arquivos compartilhados. Se especificado, o parâmetro Authorization não será necessário.
drive_id	body	String	Não	ID do drive. Mutuamente exclusivo com share_id. Especifique apenas um deles.
share_id	body	String	Não	ID do compartilhamento para arquivos compartilhados. Se especificado, não será possível especificar drive_id.
file_id	body	String	Sim	ID do arquivo a ser editado.
option	body	JSON	Não	Opções para controlar a edição do arquivo.

Parâmetros no parâmetro de solicitação option

Parâmetro	Posição	Tipo	Obrigatório	Descrição
copy	body	Boolean	Não	Define se os usuários podem copiar o conteúdo do arquivo.
readonly	body	Boolean	Não	Define se o arquivo é somente leitura. Defina como false para permitir a edição online.

Parâmetros de resposta

Parâmetro	Obrigatório	Tipo	Descrição
edit_url	Sim	String	URL de edição online.
office_access_token	Sim	String	Token de acesso. Válido por 30 minutos.
office_refresh_token	Sim	String	Token de atualização. Válido por um dia.

Exemplo de solicitação

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"option": {
		"readonly": false,
		"copy": true
	}
}

Exemplo de resposta

{
	"edit_url": "testEditUrl",
	"office_access_token": "testOfficeAccessToken",
	"office_refresh_token": "testOfficeRefreshToken"
}

3. Atualizar o token de edição online

POST /v2/file/refresh_office_edit_token

Parâmetros da solicitação

Parâmetro	Posição	Tipo	Obrigatório	Descrição
Authorization	header	String		Token de acesso.
x-share-token	header	String		Token de compartilhamento para arquivos compartilhados. Se especificado, o parâmetro Authorization não será necessário.
share_id	body	String	Não	ID do compartilhamento para arquivos compartilhados.
office_access_token	body	String	Sim	Token de acesso.
office_refresh_token	body	String	Sim	Token de atualização.

Parâmetros de resposta

Parâmetro	Obrigatório	Tipo	Descrição
office_access_token	Sim	String	Novo token de acesso. Válido por 30 minutos.
office_refresh_token	Sim	String	Novo token de atualização. Válido por um dia.

Exemplo de solicitação

{
	"office_access_token": "testOfficeAccessToken",
	"office_refresh_token": "testOfficeRefreshToken"
}

Exemplo de resposta

{
	"office_access_token": "testOfficeAccessToken",
	"office_refresh_token": "testOfficeRefreshToken"
}

4. Acessar a página de edição online

Acesse a página de edição usando tecnologia frontend. Use o SDK for JavaScript fornecido pelo Drive and Photo Service. Para obter mais informações, consulte a documentação do SDK for JavaScript.

Como alternativa, use o Alibaba Cloud Intelligent Media Management (IMM) para visualizar arquivos. Com o SDK for JavaScript do IMM, substitua as operações de token por chamadas à API do Drive and Photo Service: use get_office_edit_url para obter tokens e refresh_office_edit_token para atualizá-los. Para obter mais informações, consulte o Guia do Usuário do IMM.

Perguntas frequentes

1. Quais permissões são necessárias para a edição online?

A edição online requer permissões de atualização de arquivo tanto nos clientes web quanto nos desktop.

2. Por que não consigo editar um arquivo mesmo tendo permissões de edição?

Verifique os seguintes pontos:

Confirme se a edição online está ativada (recurso de valor agregado, desativado por padrão).
Valide se o formato do arquivo é compatível com a edição online.
Certifique-se de que o tamanho do arquivo seja inferior a 200 MB.
Consulte o administrador sobre as configurações de upload de arquivos: no Admin Console, acesse Enterprise Customize > File Settings. Garanta que o formato seja permitido e que o tamanho não exceda o limite de upload. Arquivos que violem essas configurações não podem ser editados ou salvos online.