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.
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.
Instalação
O pacote é disponível em PyPI e pode ser instalado via pip executando o seguinte comando:
pip install groupdocs-metadata-cloud
Requisitos
Dependências
| Pacote | Restrição |
|---|
| urllib3 | >= 1,15 |
| six | >= 1,10 |
| certifi | — |
| python-dateutil | — |
O SDK instala automaticamente os seguintes pacotes:
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)
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.
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 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)))
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))
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))
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))
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:
| Categoria | Exemplos |
|---|
| Operações de metadados | Extraia, adicione, defina, remova metadados por tag, nome ou valor |
| Operações de informações | Formatos de arquivo suportados, informações de documentos |
| Armazenamento e arquivos | Armazenamento API, upload/download de arquivos, gerenciamento de pastas |
| Autenticação | Configuração e autenticação API |
| Exemplos adicionais baseados em cenários estão disponíveis no .NET samples repository. | |
Como executar os testes SDK
- Clone o Python SDK repository
- Instale dependências:
pip install groupdocs-metadata-cloud - Configure credenciais em
test/test_settings.py - Execute testes a partir da raiz do repositório:
python -m unittest discover test
Para mais detalhes, visite Getting Started.
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