Metadata Cloud API | GroupDocs.Metadata

Browse our Products

Are you looking for an evaluation version of a product?

If so you can download any of the below versions for testing. The product will function as normal except for an evaluation limitation. At the time of purchase we provide a license file via email that will allow the product to work in its full capacity. If you would also like an evaluation license to test without any restrictions for 30 days, please follow the directions provided here.

Are you having troubles in downloading?

If you experience errors, when you try to download a file, make sure your network policies (enforced by your company or ISP) allow downloading ZIP and/or MSI files.

Installation
The package is available at PyPI and it can be installed via pip by executing following command:
pip install groupdocs-metadata-cloud

Requirements

Python 3.4+
pip package manager
GroupDocs Cloud credentials — Client ID and Client Secret from the Dashboard

Dependencies

The SDK automatically installs the following packages:

Package	Constraint
urllib3	>= 1.15
six	>= 1.10
certifi	—
python-dateutil	—

Document Metadata Python Cloud REST API

GroupDocs.Metadata Cloud SDK for Python is a powerful REST API client designed for comprehensive metadata management across various file formats. It empowers developers to easily extract, add, modify, and remove metadata from documents, images, audio, video, and other file types within their Python web apps, scripts, and automation workflows. The API offers advanced features for metadata filtering, searching, and preservation, ensuring data integrity during file operations. With cross-platform support and a user-friendly SDK, GroupDocs.Metadata Cloud simplifies metadata handling and streamlines integration into existing systems.

Core Metadata Management Capabilities

Comprehensive Metadata Extraction and Parsing - Efficiently retrieves and interprets metadata from documents, images, audio, video, and more.
Advanced Metadata Filtering and Searching - Employs flexible search criteria based on tags, property names, and values for precise metadata retrieval.
Dynamic Metadata Manipulation - Provides full control through seamless addition, modification, and removal of metadata properties.
Guaranteed Metadata Preservation - Maintains metadata integrity during file operations such as copying and moving.

Seamless File and Folder Operations

Robust Cloud Storage Integration - Securely interacts with files and folders residing in cloud storage.
Efficient File Upload and Download - Enables swift transfer of files between local systems and the cloud.
Intuitive File and Folder Management - Copy, move, rename, and delete files and folders within cloud storage.
Granular File Versioning - Access and manage different versions of files stored in the cloud.

Proactive Storage Administration

Storage Existence Verification - Confirm the availability and accessibility of cloud storage accounts.
Object Existence Check - Determine the presence of files or folders within cloud storage.
Storage Space Utilization Monitoring - Get insights into total and used space within storage.

Licensing and Authentication

Evaluation Mode - Try the API with a free trial account.
Secure Authentication - Use Client ID and Client Secret for secure API access.
MIT License - The Python SDK is licensed under the MIT License.

Supported Document Formats

GroupDocs.Metadata Cloud supports 100+ file formats for metadata load and save operations:

Word Processing: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT
Spreadsheets: XLS, XLSX, XLSM, XLTM, ODS
Presentations: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POTX, POTM
PDF and eBooks: PDF, EPUB
Email: MSG, EML
Images: BMP, GIF, JPEG, PNG, TIFF, WEBP, PSD, DJVU, JP2, EMF, WMF
CAD and Diagrams: DWG, DXF, VSD, VSDX, VSS, VSX, VDX
Audio and Video: MP3, WAV, AVI, MOV, QT, ASF, FLV
Archives and Other: ZIP, TORRENT, DICOM, ONE, MPP, OTF, TTF, TTC, VCF, VCR

For the complete format matrix with load/save support details, see the documentation.

Quick Start

Get your API credentials

To use GroupDocs.Metadata Cloud, sign up at GroupDocs.Cloud Dashboard and get your Client ID and Client Secret.

Initialize the API

Use the following code to start using the GroupDocs.Metadata Cloud SDK for Python:

import groupdocs_metadata_cloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create API configuration
configuration = groupdocs_metadata_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"

# Create instance of the Metadata API
metadata_api = groupdocs_metadata_cloud.MetadataApi.from_config(configuration)

Extract metadata from a document

Once initialized, use this basic example to extract metadata from a file in cloud storage:

import groupdocs_metadata_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

metadata_api = groupdocs_metadata_cloud.MetadataApi.from_keys(client_id, client_secret)

options = groupdocs_metadata_cloud.ExtractOptions()
options.file_info = groupdocs_metadata_cloud.FileInfo()
options.file_info.file_path = "documents/sample.docx"

request = groupdocs_metadata_cloud.ExtractRequest(options)
result = metadata_api.extract(request)

print("Metadata extracted successfully")

With this quick start guide, you’re all set to begin managing metadata using GroupDocs.Metadata Cloud in your Python applications. For more details, visit the documentation.

Get Supported File Formats

Retrieve the full list of supported file formats available through the Metadata API.

import groupdocs_metadata_cloud

info_api = groupdocs_metadata_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

result = info_api.get_supported_file_formats()

for fmt in result.formats:
    print("{0} ({1})".format(fmt.file_format, fmt.extension))

Extract Metadata by Tag

Extract metadata properties matching a specific tag from a document.

import groupdocs_metadata_cloud

metadata_api = groupdocs_metadata_cloud.MetadataApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_metadata_cloud.ExtractOptions()
options.file_info = groupdocs_metadata_cloud.FileInfo()
options.file_info.file_path = "documents/sample.docx"
options.search_criteria = groupdocs_metadata_cloud.SearchCriteria(
    tag_options=groupdocs_metadata_cloud.TagOptions(
        exact_tag=groupdocs_metadata_cloud.Tag(
            name="Created",
            category="Time"
        )
    )
)

request = groupdocs_metadata_cloud.ExtractRequest(options)
result = metadata_api.extract(request)

print("Properties found: " + str(len(result.properties)))

Add Custom Metadata

Add new metadata properties to a document using tag-based search criteria.

import groupdocs_metadata_cloud

metadata_api = groupdocs_metadata_cloud.MetadataApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_metadata_cloud.AddOptions()
options.file_info = groupdocs_metadata_cloud.FileInfo()
options.file_info.file_path = "documents/sample.docx"

add_property = groupdocs_metadata_cloud.AddProperty(
    value="Test User",
    type="String",
    search_criteria=groupdocs_metadata_cloud.SearchCriteriaWithoutValue(
        tag_options=groupdocs_metadata_cloud.TagOptions(
            exact_tag=groupdocs_metadata_cloud.Tag(
                name="Manager",
                category="Person"
            )
        )
    )
)
options.properties = [add_property]

request = groupdocs_metadata_cloud.AddRequest(options)
result = metadata_api.add(request)

print("Added count: " + str(result.added_count))

Modify Metadata Properties

Update existing metadata properties by tag, name, or value search criteria.

import groupdocs_metadata_cloud

metadata_api = groupdocs_metadata_cloud.MetadataApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_metadata_cloud.SetOptions()
options.file_info = groupdocs_metadata_cloud.FileInfo()
options.file_info.file_path = "documents/sample.docx"

set_property = groupdocs_metadata_cloud.SetProperty(
    new_value="NewAuthor",
    type="String",
    search_criteria=groupdocs_metadata_cloud.SearchCriteria(
        tag_options=groupdocs_metadata_cloud.TagOptions(
            exact_tag=groupdocs_metadata_cloud.Tag(
                name="Creator",
                category="Person"
            )
        )
    )
)
options.properties = [set_property]

request = groupdocs_metadata_cloud.SetRequest(options)
result = metadata_api.set(request)

print("Set count: " + str(result.set_count))

Remove Metadata Properties

Remove metadata properties from a document based on search criteria.

import groupdocs_metadata_cloud

metadata_api = groupdocs_metadata_cloud.MetadataApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_metadata_cloud.RemoveOptions()
options.file_info = groupdocs_metadata_cloud.FileInfo()
options.file_info.file_path = "documents/sample.docx"
options.search_criteria = groupdocs_metadata_cloud.SearchCriteria(
    tag_options=groupdocs_metadata_cloud.TagOptions(
        exact_tag=groupdocs_metadata_cloud.Tag(
            name="Created",
            category="Time"
        )
    )
)

request = groupdocs_metadata_cloud.RemoveRequest(options)
result = metadata_api.remove(request)

print("Removed count: " + str(result.removed_count))

Get Document Information

Retrieve document details such as format, size, and page count before processing metadata.

import groupdocs_metadata_cloud

info_api = groupdocs_metadata_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_metadata_cloud.InfoOptions()
options.file_info = groupdocs_metadata_cloud.FileInfo()
options.file_info.file_path = "documents/sample.pptx"

request = groupdocs_metadata_cloud.GetInfoRequest(options)
result = info_api.get_info(request)

print("Document info retrieved successfully")

SDK Examples on GitHub

The GroupDocs.Metadata Cloud Python SDK repository includes unit tests and API usage examples in the test/apis folder:

Category	Examples
Metadata Operations	Extract, add, set, remove metadata by tag, name, or value
Info Operations	Supported file formats, document information
Storage & Files	Storage API, file upload/download, folder management
Authentication	API configuration and authentication

Additional scenario-based examples are available in the .NET samples repository.

How to run the SDK tests

Clone the Python SDK repository
Install dependencies: pip install groupdocs-metadata-cloud
Configure credentials in test/test_settings.py
Run tests from the repository root: python -m unittest discover test

For more details, visit Getting Started.