aspose-words-cloud-go

README

Aspose.Wors Cloud SDK for Go wraps Aspose.Words REST API so you could seamlessly integrate Microsoft Word® document generation, manipulation, conversion & inspection features into your own Go applications.

Word Document Processing in the Cloud

Aspose.Words Cloud SDK for Go allows to work with document headers, footers, page numbering, tables, sections, document comments, drawing objects, FormFields, fonts, hyperlinks, ranges, paragraphs, math objects, watermarks, track changes and document protection. It also assists in appending documents, splitting documents as well as converting document to other supported file formats.

Feel free to explore the Developer's Guide & API Reference to know all about Aspose.Words Cloud API.

Document Processing Features

• Convert between various document-related formats, including Word to PDF & vice versa.
• Mail merge and report generation in the Cloud.
• Split & merge Word documents.
• Access Word document metadata.
• Find and replace text.
• Add & remove watermarks and protection.
• Read & write access to Document Object Model.

Enhancements in Version 21.3

• Added 'UpdateCreatedTimeProperty' save option
• Added Tables into HeaderFooter so it's possible to address paragraphs inside table which is located in headerfooter (sections/0/headersfooters/1/tables/0/rows/0/cells/0/paragraphs/0)

Enhancements in Version 21.2

• Added delete all comments method

Enhancements in Version 21.1

• Added online version for all API methods
• Refactoring of Go SDK, all API method signatures are changed
• Added Batch API feature

Enhancements in Version 20.11

• In configuration json file appSid / appKey has been replaced to clientId / clientSecret.
• In Words API initialization methods clientId parameter precedes clientSecret parameter.
• Fixed the problem with object updating methods (they ignored parameters with default type values).

Enhancements in Version 20.10

• Internal API changes.

Enhancements in Version 20.9

• Added Batch API feature

Enhancements in Version 20.8

• Added new api method (PUT '/words/{name}/compatibility/optimize') which is allows to optimize the document contents as well as default Aspose.Words behavior to a particular versions of MS Word
• Added 'ApplyBaseDocumentHeadersAndFootersToAppendingDocuments' option to 'DocumentEntryList' for AppendDocument API
• WithoutNodePath methods have been removed, pass null values instead

Enhancements in Version 20.7

• Added 'Markdown' save format
• Added endpoint to update paragraph format without node path (PUT '/words/{name}/paragraphs/{index}/format')

Enhancements in Version 20.6

• Added new methods:
  • DeleteAllParagraphTabStopsWithoutNodePath
  • DeleteParagraphTabStopWithoutNodePath
  • GetParagraphTabStopsWithoutNodePath
  • InsertOrUpdateParagraphTabStopWithoutNodePath
  • InsertParagraphWithoutNodePath
  • UpdateParagraphFormatWithoutNodePath
  • UpdateParagraphListFormatWithoutNodePath
  • DeleteParagraphListFormatWithoutNodePath
• DrawingObject related methods have been changed body content. Special request classes are introduced instead of strings.
• InsertOrUpdateParagraphTabStop, DeleteParagraphTabStop methods have been changed parameter order
• OoxmlSaveOptionsData.CompressionLevel property has been added

Enhancements in Version 20.5

• Added methods to work with Word document lists
  • GetLists
  • GetList
  • InsertList
  • UpdateList
  • UpdateListLevel
• Added methods to work with styles
  • GetStyles
  • UpdateStyle
  • InsertStyle
  • CopyStyle
  • GetStyleFromDocumentElement
  • ApplyStyleToDocumentElement
• Added methods to work with paragraph list format
  • GetParagraphListFormat
  • GetParagraphListFormatWithoutNodePath
  • UpdateParagraphListFormat
  • DeleteParagraphListFormat
• Added methods to work with paragraph tab stops
  • GetParagraphTabStops
  • InsertOrUpdateParagraphTabStop
  • DeleteAllParagraphTabStops
  • DeleteParagraphTabStop
• Added methods to build reports
  • BuildReport
  • BuildReportOnline
• Added Shading property to ParagraphFormat

Read & Write Document Formats

Microsoft Word: DOC, DOCX, RTF, DOT, DOTX, DOTM, FlatOPC (XML) OpenOffice: ODT, OTT WordprocessingML: XML Web: HTML, MHTML, HtmlFixed Text: TXT Fixed Layout: PDF

Save Document As

Fixed Layout: PDF/A, XPS, OpenXPS, PS Images: JPEG, PNG, BMP, SVG, TIFF, EMF Others: PCL

Getting Started with Aspose.Words Cloud SDK for Go

Firstly, create an account at Aspose for Cloud to get your application information and free quota to use the API.

Install Aspose.Words-Cloud

From Visual Stuio Code:

Add "github.com/aspose-words-cloud/aspose-words-cloud-go/v2007/api" and "github.com/aspose-words-cloud/aspose-words-cloud-go/v2007/api/models" in the import section of your code

From the command line:

go get -v github.com/aspose-words-cloud/aspose-words-cloud-go/2007/api

The complete source code is available at GitHub Repository.

SDK Dependencies

The libraray doesn't uses any non-Google Golang packages.

Sample usage via the SDK

The examples below show how your application have to initiate and get a text of the first paragraph using Aspose.Words-Cloud library:

Config.json file:

{
	"ClientId": "your client id",
	"ClientSecret": "your client secret",
	"BaseUrl": "https://api.aspose.cloud"
} 

Go code:

	// Start README example

	// init words cloud api
	config, _ := models.NewConfiguration(configFilePath)
	wordsApi, ctx, _ := api.CreateWordsApi(config)

	// upload test.docx to a cloud
	// remote.docx is a name in the cloud
	file, _ := os.Open(localFilePath)
	wordsApi.UploadFile(ctx, file, remotePath, nil)

	// get a text for the first paragraph of the first section
	options := map[string]interface{}{
		"folder": remoteFolder,
	}

	result, _, _ := wordsApi.GetParagraphs(ctx, remoteName, options)

	fmt.Println(result.Paragraphs.ParagraphLinkList[0].Text)

	// End README example

Product Page | Documentation | API Reference | Code Samples | Blog | Free Support | Free Trial