Instalación

El paquete es available en PyPI y se puede instalar a través de pip ejecutando el siguiente comando:

pip install groupdocs-metadata-cloud

Requisitos

• Python 3.4+
• administrador de paquetes pip
• Credenciales de nube de GroupDocs — Client ID and Client Secret desde el tablero

Dependencias

El SDK instala automáticamente los siguientes paquetes:

API REST de metadatos de documentos de Python Cloud

GroupDocs.Metadata Cloud SDK para Python es un potente cliente API REST diseñado para la gestión integral de metadatos en varios formatos de archivos. Permite a los desarrolladores extraer, agregar, modificar y eliminar fácilmente metadatos de documentos, imágenes, audio, video y otros tipos de archivos dentro de sus aplicaciones web Python, scripts y flujos de trabajo de automatización. La API ofrece funciones avanzadas para el filtrado, la búsqueda y la preservación de metadatos, lo que garantiza la integridad de los datos durante las operaciones de archivos. Con soporte multiplataforma y un SDK fácil de usar, GroupDocs.Metadata Cloud simplifica el manejo de metadatos y agiliza la integración en los sistemas existentes.

Capacidades principales de gestión de metadatos

Extracción y análisis integral de metadatos: recupera e interpreta de manera eficiente metadatos de documentos, imágenes, audio, video y más.
Búsqueda y filtrado de metadatos avanzados: emplea criterios de búsqueda flexibles basados ​​en etiquetas, nombres de propiedades y valores para una recuperación precisa de metadatos.
Manipulación dinámica de metadatos: proporciona control total mediante la adición, modificación y eliminación perfecta de propiedades de metadatos.
Preservación de metadatos garantizada: mantiene la integridad de los metadatos durante las operaciones de archivos, como copiar y mover.

Operaciones fluidas de archivos y carpetas

Sólida integración de almacenamiento en la nube: interactúa de forma segura con archivos y carpetas que residen en el almacenamiento en la nube.
Carga y descarga de archivos eficiente: permite una transferencia rápida de archivos entre sistemas locales y la nube.
Administración intuitiva de archivos y carpetas: copie, mueva, cambie el nombre y elimine archivos y carpetas dentro del almacenamiento en la nube.
Versión granular de archivos: acceda y administre diferentes versiones de archivos almacenados en la nube.

Administración de almacenamiento proactiva

Verificación de existencia de almacenamiento: confirme la disponibilidad y accesibilidad de las cuentas de almacenamiento en la nube.
Verificación de existencia de objetos: determina la presencia de archivos o carpetas dentro del almacenamiento en la nube.
Supervisión de la utilización del espacio de almacenamiento: obtenga información sobre el espacio total y utilizado dentro del almacenamiento.

Licencias y autenticación

Modo de evaluación: prueba la API con una cuenta de prueba gratuita.
Autenticación segura: utilice el ID de cliente y el secreto de cliente para obtener acceso seguro a la API.
Licencia MIT: el SDK para Python tiene la licencia de MIT License.

Formatos de documentos admitidos

GroupDocs.Metadata Cloud admite más de 100 formatos de archivo para operaciones de carga y guardado de metadatos:

• Procesamiento de textos: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT
• Hojas de cálculo: XLS, XLSX, XLSM, XLTM, ODS
• Presentaciones: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POTX, POTM
• PDF y libros electrónicos: PDF, EPUB
• Correo electrónico: MSG, EML
• Imágenes: BMP, GIF, JPEG, PNG, TIFF, WEBP, PSD, DJVU, JP2, EMF, WMF
• CAD y Diagramas: DWG, DXF, VSD, VSDX, VSS, VSX, VDX
• Audio y vídeo: MP3, WAV, AVI, MOV, QT, ASF, FLV
• Archivos y otros: ZIP, TORRENT, DICOM, ONE, MPP, OTF, TTF, TTC, VCF, VCR

Para obtener la matriz de formato completa con detalles de soporte para cargar/guardar, consulte la documentation.

Inicio rápido

Obtenga sus credenciales API

Para utilizar GroupDocs.Metadata Cloud, regístrese en GroupDocs.Cloud Dashboard y obtenga su ID de cliente y su Secreto de cliente.

Inicializar la API

Utilice el siguiente código para comenzar a utilizar 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)

Extraer metadatos de un documento

Una vez inicializado, utilice este ejemplo básico para extraer metadatos de un archivo en el almacenamiento en la nube:

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

Con esta guía de inicio rápido, estará listo para comenzar a administrar metadatos usando GroupDocs.Metadata Cloud en sus aplicaciones Python. Para más detalles, visite el documentation.

Obtenga formatos de archivo compatibles

Recupere la lista completa de formatos de archivo compatibles disponibles a través de la API de metadatos.

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

Extraer metadatos por etiqueta

Extraiga propiedades de metadatos que coincidan con una etiqueta específica de un 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)))

Agregar metadatos personalizados

Agregue nuevas propiedades de metadatos a un documento utilizando criterios de búsqueda basados ​​en etiquetas.

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 propiedades de metadatos

Actualice las propiedades de metadatos existentes por etiqueta, nombre o criterio de búsqueda de 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))

Eliminar propiedades de metadatos

Elimine las propiedades de metadatos de un documento según los criterios de búsqueda.

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

Obtener información del documento

Recupere detalles del documento, como formato, tamaño y recuento de páginas, antes de procesar los metadatos.

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

Ejemplos de SDK en GitHub

El GroupDocs.Metadata Cloud Python SDK El repositorio incluye pruebas unitarias y ejemplos de uso de API en eltest/apiscarpeta:

Hay ejemplos adicionales basados ​​en escenarios disponibles en el .NET samples repository.

Cómo ejecutar las pruebas del SDK

1. Clonar el Python SDK repository2. Instalar dependencias:pip install groupdocs-metadata-cloud3. Configure las credenciales entest/test_settings.py4. Ejecute pruebas desde la raíz del repositorio:python -m unittest discover test

Para más detalles, visite Getting Started.

Etiquetas

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