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.
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
Dépendances
Le SDK installe automatiquement les packages suivants :
| Package | Contrainte |
|---|
| urllib3 | >= 1.15 |
| six | >= 1.10 |
| certifi | — |
| python-dateutil | — |
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)
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.
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))
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))
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 :
| Catégorie | Exemples |
|---|
| Opérations sur les métadonnées | Extraire, ajouter, définir, supprimer les métadonnées par balise, nom ou valeur |
| Opérations Info | Formats de fichiers pris en charge, informations sur les documents |
| Stockage et fichiers | API Storage, téléversement/téléchargement de fichiers, gestion des dossiers |
| Authentification | Configuration et authentification de l’API |
Des exemples supplémentaires basés sur des scénarios sont disponibles dans le dépôt d’exemples .NET.
- Clonez le dépôt SDK Python
- Installez les dépendances :
pip install groupdocs-metadata-cloud - Configurez les identifiants dans
test/test_settings.py - Exécutez les tests depuis la racine du dépôt :
python -m unittest discover test
Pour plus de détails, consultez 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