Installation

Le package est disponible sur PyPI et peut être installé via pip en exécutant la commande suivante :

pip install groupdocs-metadata-cloud

Exigences

• Python 3.4+
• Gestionnaire de packages pip
• Identifiants GroupDocs Cloud — Client ID et Client Secret depuis le Dashboard

Dépendances

Le SDK installe automatiquement les packages suivants :

API Cloud REST Python de métadonnées de documents

GroupDocs.Metadata Cloud SDK pour Python est un client API REST puissant conçu pour une gestion complète des métadonnées dans divers formats de fichiers. Il permet aux développeurs d’extraire, d’ajouter, de modifier et de supprimer facilement les métadonnées de documents, images, audio, vidéo et autres types de fichiers au sein de leurs applications web Python, scripts et flux de travail d’automatisation. L’API offre des fonctionnalités avancées de filtrage, de recherche et de préservation des métadonnées, garantissant l’intégrité des données lors des opérations sur les fichiers. Avec une prise en charge multiplateforme et un SDK convivial, GroupDocs.Metadata Cloud simplifie la gestion des métadonnées et rationalise l’intégration dans les systèmes existants.

Capacités principales de gestion des métadonnées

Extraction et analyse complètes des métadonnées - Récupère et interprète efficacement les métadonnées de documents, images, audio, vidéo et plus encore.
Filtrage et recherche avancés des métadonnées - Utilise des critères de recherche flexibles basés sur les balises, les noms de propriétés et les valeurs pour une récupération précise des métadonnées.
Manipulation dynamique des métadonnées - Offre un contrôle total grâce à l’ajout, la modification et la suppression transparents des propriétés de métadonnées.
Préservation garantie des métadonnées - Maintient l’intégrité des métadonnées lors d’opérations sur les fichiers telles que la copie et le déplacement.

Opérations transparentes sur les fichiers et dossiers

Intégration robuste du stockage cloud - Interagit de manière sécurisée avec les fichiers et dossiers stockés dans le cloud.
Téléversement et téléchargement efficaces des fichiers - Permet un transfert rapide de fichiers entre les systèmes locaux et le cloud.
Gestion intuitive des fichiers et dossiers - Copiez, déplacez, renommez et supprimez des fichiers et dossiers dans le stockage cloud.
Versionnage granulaire des fichiers - Accédez et gérez différentes versions de fichiers stockés dans le cloud.

Administration proactive du stockage

Vérification de l’existence du stockage - Confirmez la disponibilité et l’accessibilité des comptes de stockage cloud.
Vérification de l’existence des objets - Déterminez la présence de fichiers ou de dossiers dans le stockage cloud.
Surveillance de l’utilisation de l’espace de stockage - Obtenez des informations sur l’espace total et utilisé dans le stockage.

Licence et authentification

Mode d’évaluation - Essayez l’API avec un compte d’essai gratuit.
Authentification sécurisée - Utilisez Client ID et Client Secret pour un accès API sécurisé.
Licence MIT - Le SDK Python est sous licence MIT License.

Formats de documents pris en charge

GroupDocs.Metadata Cloud prend en charge plus de 100 formats de fichiers pour les opérations de chargement et d’enregistrement des métadonnées :

• Traitement de texte : DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT
• Feuilles de calcul : XLS, XLSX, XLSM, XLTM, ODS
• Présentations : PPT, PPTX, PPTM, PPS, PPSX, PPSM, POTX, POTM
• PDF et livres électroniques : PDF, EPUB
• E-mail : MSG, EML
• Images : BMP, GIF, JPEG, PNG, TIFF, WEBP, PSD, DJVU, JP2, EMF, WMF
• CAO et diagrammes : DWG, DXF, VSD, VSDX, VSS, VSX, VDX
• Audio et vidéo : MP3, WAV, AVI, MOV, QT, ASF, FLV
• Archives et autres : ZIP, TORRENT, DICOM, ONE, MPP, OTF, TTF, TTC, VCF, VCR

Pour la matrice complète des formats avec les détails de prise en charge du chargement/enregistrement, consultez la documentation.

Démarrage rapide

Obtenez vos identifiants API

Pour utiliser GroupDocs.Metadata Cloud, inscrivez-vous sur le GroupDocs.Cloud Dashboard et obtenez votre Client ID et votre Client Secret.

Initialiser l’API

Utilisez le code suivant pour commencer à utiliser GroupDocs.Metadata Cloud SDK pour 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)

Extraire les métadonnées d’un document

Une fois initialisé, utilisez cet exemple de base pour extraire les métadonnées d’un fichier dans le stockage cloud :

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

Avec ce guide de démarrage rapide, vous êtes prêt à commencer la gestion des métadonnées avec GroupDocs.Metadata Cloud dans vos applications Python. Pour plus de détails, consultez la documentation.

Obtenir les formats de fichiers pris en charge

Récupérez la liste complète des formats de fichiers pris en charge via l’API Metadata.

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

Extraire les métadonnées par balise

Extrayez les propriétés de métadonnées correspondant à une balise spécifique d’un 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)))

Ajouter des métadonnées personnalisées

Ajoutez de nouvelles propriétés de métadonnées à un document à l’aide de critères de recherche basés sur les balises.

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

Modifier les propriétés de métadonnées

Mettez à jour les propriétés de métadonnées existantes par critères de recherche de balise, de nom ou de valeur.

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

Supprimer les propriétés de métadonnées

Supprimez les propriétés de métadonnées d’un document en fonction des critères de recherche.

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

Obtenir les informations du document

Récupérez les détails du document tels que le format, la taille et le nombre de pages avant de traiter les métadonnées.

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

Exemples SDK sur GitHub

Le dépôt GroupDocs.Metadata Cloud Python SDK inclut des tests unitaires et des exemples d’utilisation de l’API dans le dossier test/apis :

Des exemples supplémentaires basés sur des scénarios sont disponibles dans le dépôt d’exemples .NET.

Comment exécuter les tests du SDK

1. Clonez le dépôt SDK Python
2. Installez les dépendances : pip install groupdocs-metadata-cloud
3. Configurez les identifiants dans test/test_settings.py
4. Exécutez les tests depuis la racine du dépôt : python -m unittest discover test

Pour plus de détails, consultez 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