Instalação

O pacote é disponível em PyPI e pode ser instalado via pip executando o seguinte comando:

pip install groupdocs-metadata-cloud

Requisitos

• Python 3.4+
• pip gerenciador de pacotes
• GroupDocs Credenciais Cloud — Client ID and Client Secret do Dashboard

Dependências

O SDK instala automaticamente os seguintes pacotes:

Metadados do Documento Python Cloud REST API

GroupDocs.Metadata Cloud SDK para Python é um poderoso cliente REST API projetado para gerenciamento abrangente de metadados em vários formatos de arquivo. Ele permite que os desenvolvedores extraiam, adicionem, modifiquem e removam facilmente metadados de documentos, imagens, áudio, vídeo e outros tipos de arquivos em seus aplicativos web Python, scripts e fluxos de trabalho de automação. O API oferece recursos avançados para filtragem, busca e preservação de metadados, garantindo a integridade dos dados durante as operações de arquivos. Com suporte multiplataforma e um SDK fácil de usar, GroupDocs.Metadata Cloud simplifica o manuseio de metadados e agiliza a integração em sistemas existentes.

Principais recursos de gerenciamento de metadados

Extração e análise abrangente de metadados - Recupera e interpreta com eficiência metadados de documentos, imagens, áudio, vídeo e muito mais.
Filtragem e pesquisa avançada de metadados - Emprega critérios de pesquisa flexíveis com base em tags, nomes de propriedades e valores para recuperação precisa de metadados.
Manipulação dinâmica de metadados – Fornece controle total por meio de adição, modificação e remoção contínua de propriedades de metadados.
Preservação garantida de metadados – Mantém a integridade dos metadados durante operações de arquivo, como cópia e movimentação.

Operações contínuas de arquivos e pastas

Integração robusta de armazenamento Cloud – Interage de forma segura com arquivos e pastas residentes no armazenamento em nuvem.
Upload e download eficiente de arquivos - Permite a transferência rápida de arquivos entre sistemas locais e a nuvem.
Gerenciamento intuitivo de arquivos e pastas - Copie, mova, renomeie e exclua arquivos e pastas no armazenamento em nuvem.
Controle de versão granular de arquivos - Acesse e gerencie diferentes versões de arquivos armazenados na nuvem.

Administração proativa de armazenamento

Verificação de existência de armazenamento – Confirme a disponibilidade e acessibilidade de contas de armazenamento em nuvem.
Verificação de existência de objeto – Determine a presença de arquivos ou pastas no armazenamento em nuvem.
Monitoramento da utilização do espaço de armazenamento – Obtenha insights sobre o espaço total e usado no armazenamento.

Licenciamento e Autenticação

Modo de avaliação - Experimente o API com uma conta de teste gratuita.
Autenticação segura – Use o ID do cliente e o segredo do cliente para acesso seguro ao API.
Licença MIT - O Python SDK é licenciado sob MIT License.

Formatos de documentos suportados

GroupDocs.Metadata Cloud suporta mais de 100 formatos de arquivo para operações de carregamento e salvamento de metadados:

• Processamento de texto: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT
• Planilhas: XLS, XLSX, XLSM, XLTM, ODS
• Apresentações: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POTX, POTM
• PDF e e-books: PDF, EPUB
• E-mail: MSG, EML
• Imagens: BMP, GIF, JPEG, PNG, TIFF, WEBP, PSD, DJVU, JP2, EMF, WMF
• CAD e diagramas: DWG, DXF, VSD, VSDX, VSS, VSX, VDX
• Áudio e Vídeo: MP3, WAV, AVI, MOV, QT, ASF, FLV
• Arquivos e outros: ZIP, TORRENT, DICOM, ONE, MPP, OTF, TTF, TTC, VCF, VCR Para a matriz de formato completa com detalhes de suporte para carregar/salvar, consulte documentation.

Início rápido

Obtenha suas credenciais API

Para usar GroupDocs.Metadata Cloud, cadastre-se em GroupDocs.Cloud Dashboard e obtenha seu ID do cliente e Segredo do cliente.

Inicialize o API

Use o código a seguir para começar a usar GroupDocs.Metadata Cloud SDK para 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)

Extraia metadados de um documento

Depois de inicializado, use este exemplo básico para extrair metadados de um arquivo no armazenamento em nuvem:

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")

Com este guia de início rápido, você está pronto para começar a gerenciar metadados usando GroupDocs.Metadata Cloud em seus aplicativos Python. Para mais detalhes, visite documentation.

Obtenha formatos de arquivo suportados

Recupere a lista completa de formatos de arquivo suportados disponíveis através dos Metadados 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))

Extraia metadados por tag

Extraia propriedades de metadados que correspondam a uma tag específica de um documento.

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)))

Adicionar metadados personalizados

Adicione novas propriedades de metadados a um documento usando critérios de pesquisa baseados em tags.

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))

Modificar propriedades de metadados

Atualize as propriedades de metadados existentes por critérios de pesquisa de tag, nome ou valor.

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))

Remover propriedades de metadados

Remova propriedades de metadados de um documento com base em critérios de pesquisa.

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))

Obtenha informações do documento

Recupere detalhes do documento, como formato, tamanho e contagem de páginas, antes de processar metadados.

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 Exemplos em GitHub

O repositório GroupDocs.Metadata Cloud Python SDK inclui testes de unidade e exemplos de uso de API na pasta test/apis:

Como executar os testes SDK

1. Clone o Python SDK repository
2. Instale dependências: pip install groupdocs-metadata-cloud
3. Configure credenciais em test/test_settings.py
4. Execute testes a partir da raiz do repositório: python -m unittest discover test Para mais detalhes, visite Getting Started.

Tags

Document Metadata API | Python Cloud API | GroupDocs.Metadata Cloud | REST API | Metadata Extraction | Metadata Management | Metadata Filtering | Metadata Searching | Metadata Preservation | Cloud Storage Integration | File Management | Folder Management | File Versioning | Secure API Access | Cross-Platform API | PDF Metadata | Image Metadata | Video Metadata | Audio Metadata | Document Metadata Editing | MIT License