保护 Excel Workboo

此 REST API 保护 Excel workbook。

查询参数

参数名称	类型	描述
文件夹	细绳	原始工作簿文件夹。
存储名称	细绳	存储名称。

请求体参数

参数名称	类型	描述
保护	工作簿保护请求

工作簿保护请求

参数名称	类型	描述
保护类型	细绳	全部/内容/无/物体/场景/结构/窗口
密码	细绳

休息 API

API	类型	描述	Swagger 链接
/细胞/{名称}/保护	邮政	保护文档	后保护文档

这OpenAPI规范定义一个可公开访问的编程接口，并允许您直接从 Web 浏览器执行 REST 交互。

您可以使用cURL命令行工具可轻松访问 Aspose.Cells 的 Web 服务。以下示例展示了如何使用 cURL 调用 Cloud API。

Request


curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/protection" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"ProtectionType\": \"all\", \"Password\": \"aspose\"}"

Response


{

  "Code":"200",

  "Status":"OK"

}

Cloud SDK 系列

使用 SDK 是加速开发的最佳方式。SDK 负责处理底层细节，让您专注于项目任务。请查看GitHub 存储库以获取 Aspose.Cells Cloud SDKs 的完整列表。

以下代码示例演示了如何使用各种 SDK 调用 Aspose.Cells Web 服务：

	namespace Aspose.Cells.Cloud.SDK.Tests.Api.Example
	{
	using Microsoft.VisualStudio.TestTools.UnitTesting;
	using Aspose.Cells.Cloud.SDK.Request;
	using System.Collections.Generic;
	using Aspose.Cells.Cloud.SDK.Api;
	using System;
	using System.IO;

	[TestClass]
	public class CellsApiExample
	{
	string CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
	string CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications
	private readonly string remoteFolder = "TestData/In";
	string localName = "Book1.xlsx";
	string remoteName = "remote_book1.xlsx";
	string localPath = "D:/TestData/CellsCloud";
	[TestCategory("Cells")]
	[TestMethod]
	public void Example()
	{


	UploadFileRequest uploadFileRequest = new UploadFileRequest();
	FileInfo fileInfo = new FileInfo(localPath + "/" + localName);
	uploadFileRequest.path = remoteFolder + "/" + remoteName;
	uploadFileRequest.storageName = "";
	uploadFileRequest.UploadFiles = new Dictionary<string, Stream>() { { localName, File.OpenRead(localPath +"/"+ localName) } };
	cellsApi.UploadFile(uploadFileRequest);


	var protectWorkbookRequest = new ProtectWorkbookRequest()
	{
	EncryptWithPassword = "123456",
	ProtectWorkbookStructure = "ALL"
	};
	var request = new PostProtectWorkbookRequest(
	name: remoteName,
	protectWorkbookRequest: protectWorkbookRequest,
	folder: remoteFolder,
	storageName: ""
	);
	cellsApi.PostProtectWorkbook(request);







	}


	}
	}

view raw ExamplePostProtectWorkbook.cs hosted with ❤ by GitHub

Java

	package com.aspose.cloud.cells.api;
	import com.aspose.cloud.cells.client.*;
	import com.aspose.cloud.cells.model.*;
	import com.aspose.cloud.cells.request.*;
	import java.io.IOException;
	import org.junit.Test;
	import java.util.ArrayList;
	import java.util.List;
	import java.io.File;
	import java.util.HashMap;

	public class Example {
	private CellsApi api;
	public Example(){
	try {
	api = new CellsApi(
	System.getenv("CellsCloudClientId"),
	System.getenv("CellsCloudClientSecret"),
	"v3.0",
	System.getenv("CellsCloudApiBaseUrl")
	);
	} catch (ApiException e) {
	e.printStackTrace();
	}
	}

	public void Run(){
	try{
	String remoteFolder = "TestData/In";

	String localName = "Book1.xlsx";
	String remoteName = "Book1.xlsx";

	UploadFileRequest uploadFileRequest = new UploadFileRequest();
	uploadFileRequest.setPath( remoteFolder + "/" + remoteName );
	uploadFileRequest.setStorageName( "");
	HashMap<String,File> files = new HashMap<String,File>();
	files.put( localName , new File(localName ));
	uploadFileRequest.setUploadFiles(files);
	api.uploadFile(uploadFileRequest);

	PostProtectWorkbookRequest request = new PostProtectWorkbookRequest();
	request.setName(remoteName);

	ProtectWorkbookRequest protectWorkbookRequest = new ProtectWorkbookRequest();
	protectWorkbookRequest.setEncryptWithPassword("123456");


	protectWorkbookRequest.setProtectWorkbookStructure("ALL");

	request.setProtectWorkbookRequest(protectWorkbookRequest);

	request.setFolder(remoteFolder);

	request.setStorageName("");

	this.api.postProtectWorkbook(request);

	} catch (ApiException e) {
	e.printStackTrace();
	}catch (IOException e) {
	e.printStackTrace();
	}
	}
	}

view raw Example_PostProtectWorkbook.java hosted with ❤ by GitHub

PHP

	<?php
	require_once('vendor\autoload.php');
	use \Aspose\Cells\Cloud\Api\CellsApi;
	use \Aspose\Cells\Cloud\Request\PostProtectWorkbookRequest;

	$CellsCloudClientId = "...." ; # get from https://dashboard.aspose.cloud/#/applications
	$CellsCloudClientSecret = "...."; # get from https://dashboard.aspose.cloud/#/applications
	$cellsApi = new CellsApi($CellsCloudClientId , $CellsCloudClientSecret );

	$remoteFolder = "TestData/In";

	$localName = "Book1.xlsx";
	$remoteName = "Book1.xlsx";

	$protectWorkbookRequest = new \Aspose\Cells\Cloud\Model\ProtectWorkbookRequest();
	$protectWorkbookRequest->setEncryptWithPassword("123456" );
	$protectWorkbookRequest->setProtectWorkbookStructure("ALL" );


	$request = new PostProtectWorkbookRequest();
	$request->setName( $remoteName);
	$request->setProtectWorkbookRequest( $protectWorkbookRequest);
	$request->setFolder( $remoteFolder);
	$request->setStorageName( "");
	$cellsApi->postProtectWorkbook($request);

view raw Example_PostProtectWorkbook.php hosted with ❤ by GitHub

Ruby

	require 'openssl'
	require 'bundler'
	require 'aspose_cells_cloud'


	CellsCloudClientId = "...." # get from https://dashboard.aspose.cloud/#/applications
	CellsCloudClientSecret = "...." # get from https://dashboard.aspose.cloud/#/applications
	@instance = AsposeCellsCloud::CellsApi.new(CellsCloudClientId, CellsCloudClientSecret)

	remote_folder = 'TestData/In'

	local_name = 'Book1.xlsx'
	remote_name = 'Book1.xlsx'


	mapFiles = { }
	mapFiles[local_name] = ::File.open(File.expand_path("TestData/"+local_name),"r")

	uploadrequest = AsposeCellsCloud::UploadFileRequest.new( { :UploadFiles=>mapFiles,:path=>remote_folder })
	@instance.upload_file(uploadrequest)
	protectWorkbookRequest = AsposeCellsCloud::ProtectWorkbookRequest.new(:EncryptWithPassword=>'123456' ,:ProtectWorkbookStructure=>'ALL' );
	request = AsposeCellsCloud::PostProtectWorkbookRequest.new(:name=>remote_name,:protectWorkbookRequest=>protectWorkbookRequest,:folder=>remote_folder,:storageName=>'');
	@instance.post_protect_workbook(request);

view raw Example_PostProtectWorkbook.rb hosted with ❤ by GitHub

Node.js

	import { CellsApi,ProtectWorkbookRequest,PostProtectWorkbookRequest,UploadFileRequest } from "asposecellscloud";
	var fs = require('fs');
	var path = require('path');
	var process = require('process');
	const _ = require('asposecellscloud');

	const CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
	const CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications
	const cellsApi = new CellsApi(CellsCloudClientId, CellsCloudClientSecret);

	var remoteFolder = "TestData/In"
	var localPath = "TestData/CellsCloud/"
	var localName = "Book1.xlsx"
	var remoteName = "Book1.xlsx"


	describe('example', function(){
	it("should call successfully" , function(){
	var localNameRequest = new UploadFileRequest();
	localNameRequest.uploadFiles ={localName:fs.createReadStream(localPath + localName)};
	localNameRequest.path = remoteFolder + "/" + remoteName ;
	localNameRequest.storageName ="";
	cellsApi.uploadFile(localNameRequest );

	var protectWorkbookRequest = new ProtectWorkbookRequest();
	protectWorkbookRequest.encryptWithPassword = "123456" ;
	protectWorkbookRequest.protectWorkbookStructure = "ALL" ;

	var request = new PostProtectWorkbookRequest();
	request.name = remoteName;
	request.protectWorkbookRequest = protectWorkbookRequest;
	request.folder = remoteFolder;
	request.storageName = "";
	return cellsApi.postProtectWorkbook(request)
	});

view raw Example_PostProtectWorkbook.ts hosted with ❤ by GitHub

Python

	import os
	import sys

	from asposecellscloud.apis.cells_api import CellsApi
	from asposecellscloud.models import *
	from asposecellscloud.requests import *

	CellsCloudClientId ='....' # get from https://dashboard.aspose.cloud/#/applications
	CellsCloudClientSecret='....' # get from https://dashboard.aspose.cloud/#/applications
	api = CellsApi(CellsCloudClientId,CellsCloudClientSecret)
	protectWorkbookRequest = ProtectWorkbookRequest(encrypt_with_password= '123456' ,protect_workbook_structure= 'ALL' )
	request = PostProtectWorkbookRequest( 'Book1.xlsx', protectWorkbookRequest,folder= 'PythonTest',storage_name= '')
	api.post_protect_workbook(request)

view raw Example_PostProtectWorkbook.py hosted with ❤ by GitHub

Perl

	use lib 'lib';
	use strict;
	use warnings;
	use File::Slurp;
	use MIME::Base64;
	use AsposeCellsCloud::CellsApi;

	my $CellsCloudClientId = "...."; # get from https://dashboard.aspose.cloud/#/applications
	my $CellsCloudClientSecret = "...."; # get from https://dashboard.aspose.cloud/#/applications
	my $config = AsposeCellsCloud::Configuration->new( client_id => $CellsCloudClientId , client_secret => $CellsCloudClientSecret );

	my $instance = AsposeCellsCloud::CellsApi->new(AsposeCellsCloud::ApiClient->new( $config));

	my $remoteFolder = 'TestData/In';

	my $localName = 'Book1.xlsx';
	my $remoteName = 'Book1.xlsx';

	my $upload_file_request = AsposeCellsCloud::Request::UploadFileRequest->new( 'UploadFiles'=>{ $localName => $localName } ,'path'=>$remoteFolder . '/' . $remoteName );

	my $protect_workbook_request = AsposeCellsCloud::Object::ProtectWorkbookRequest->new();
	$protect_workbook_request->{encrypt_with_password} = '123456' ;
	$protect_workbook_request->{protect_workbook_structure} = 'ALL' ;

	my $request = AsposeCellsCloud::Request::PostProtectWorkbookRequest->new();
	$request->{name} = $remoteName;
	$request->{protect_workbook_request} = $protect_workbook_request;
	$request->{folder} = $remoteFolder;
	$request->{storage_name} = '';
	$instance->post_protect_workbook(request=> $request);

view raw Example_PostProtectWorkbook.pl hosted with ❤ by GitHub

	package main

	import (
	. "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v25"
	)

	func main() {
	CellsCloudClientId := "...." // get from https://dashboard.aspose.cloud/#/applications
	CellsCloudClientSecret := "...." // get from https://dashboard.aspose.cloud/#/applications
	instance := NewCellsApiService(CellsCloudClientId, CellsCloudClientSecret)
	remoteFolder := "TestData/In"

	localName := "Book1.xlsx"
	remoteName := "Book1.xlsx"

	localNameRequest := new(UploadFileRequest)
	localNameRequest.UploadFiles = make(map[string]string)
	localNameRequest.UploadFiles[localName] = localName
	localNameRequest.Path = remoteFolder + "/" + remoteName
	localNameRequest.StorageName = ""
	instance.UploadFile(localNameRequest)

	var protectWorkbookRequest = new(ProtectWorkbookRequest)
	protectWorkbookRequest.EncryptWithPassword = "123456"
	protectWorkbookRequest.ProtectWorkbookStructure = "ALL"

	request := new(PostProtectWorkbookRequest)
	request.Name = remoteName
	request.ProtectWorkbookRequest = protectWorkbookRequest
	request.Folder = remoteFolder
	request.StorageName = ""
	_, httpResponse, err := instance.PostProtectWorkbook(request)
	if err != nil {
	println(err.Error())
	} else if httpResponse.StatusCode < 200 \|\| httpResponse.StatusCode > 299 {
	println("Fail")
	}
	}

view raw Example_PostProtectWorkbook.go hosted with ❤ by GitHub

加密 Excel 工作簿为 Excel workboo 添加数字签名