Installation

Das Paket ist verfügbar bei PyPI und kann über pip mit folgendem Befehl installiert werden:

pip install groupdocs-metadata-cloud

Anforderungen

• Python 3.4+
• pip Paketmanager
• GroupDocs Cloud-Anmeldeinformationen — Client ID and Client Secret vom Dashboard

Abhängigkeiten

Das SDK installiert automatisch die folgenden Pakete:

Metadaten Python Cloud REST API

GroupDocs.Metadata Cloud SDK für Python ist ein leistungsstarker REST API-Client für umfassende Metadatenverwaltung in verschiedenen Dateiformaten. Er ermöglicht Entwicklern, Metadaten aus Dokumenten, Bildern, Audio, Video und anderen Dateitypen in ihren Python-Web-Apps, Skripten und Automatisierungs-Workflows einfach zu extrahieren, hinzuzufügen, zu ändern und zu entfernen. Die API bietet erweiterte Funktionen zum Filtern, Suchen und Bewahren von Metadaten und gewährleistet die Datenintegrität bei Dateioperationen. Mit plattformübergreifender Unterstützung und einem benutzerfreundlichen SDK vereinfacht GroupDocs.Metadata Cloud die Metadatenverarbeitung und optimiert die Integration in bestehende Systeme.

Kernfunktionen der Metadatenverwaltung

Umfassende Metadatenextraktion und -analyse - Ruft Metadaten aus Dokumenten, Bildern, Audio, Video und mehr effizient ab und interpretiert sie.
Erweiterte Metadatenfilterung und -suche - Verwendet flexible Suchkriterien basierend auf Tags, Eigenschaftsnamen und Werten für präzise Metadatenabfragen.
Dynamische Metadatenmanipulation - Bietet volle Kontrolle durch nahtloses Hinzufügen, Ändern und Entfernen von Metadaten-Eigenschaften.
Garantierte Metadatenbewahrung - Erhält die Metadatenintegrität bei Dateioperationen wie Kopieren und Verschieben.

Nahtlose Datei- und Ordneroperationen

Robuste Cloud-Speicherintegration - Interagiert sicher mit Dateien und Ordnern in Cloud-Speichern.
Effizienter Datei-Upload und -Download - Ermöglicht schnelle Übertragung von Dateien zwischen lokalen Systemen und der Cloud.
Intuitive Datei- und Ordnerverwaltung - Kopieren, Verschieben, Umbenennen und Löschen von Dateien und Ordnern im Cloud-Speicher.
Granulare Dateiversionierung - Zugriff auf und Verwaltung verschiedener Versionen von Dateien in der Cloud.

Proaktive Speicherverwaltung

Speicher-Existenzprüfung - Bestätigen Sie die Verfügbarkeit und Zugänglichkeit von Cloud-Speicherkonten.
Objekt-Existenzprüfung - Ermitteln Sie das Vorhandensein von Dateien oder Ordnern im Cloud-Speicher.
Überwachung der Speichernutzung - Erhalten Sie Einblicke in den gesamten und genutzten Speicherplatz.

Lizenzierung und Authentifizierung

Evaluierungsmodus - Testen Sie die API mit einem kostenlosen Testkonto.
Sichere Authentifizierung - Verwenden Sie Client ID und Client Secret für sicheren API-Zugriff.
MIT License - Das Python SDK ist unter der MIT License lizenziert.

Unterstützte Dateiformate

GroupDocs.Metadata Cloud unterstützt über 100 Dateiformate für Metadaten-Lade- und Speicheroperationen:

• Textverarbeitung: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT
• Tabellenkalkulationen: XLS, XLSX, XLSM, XLTM, ODS
• Präsentationen: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POTX, POTM
• PDF und E-Books: PDF, EPUB
• E-Mail: MSG, EML
• Bilder: BMP, GIF, JPEG, PNG, TIFF, WEBP, PSD, DJVU, JP2, EMF, WMF
• CAD und Diagramme: DWG, DXF, VSD, VSDX, VSS, VSX, VDX
• Audio und Video: MP3, WAV, AVI, MOV, QT, ASF, FLV
• Archive und Sonstiges: ZIP, TORRENT, DICOM, ONE, MPP, OTF, TTF, TTC, VCF, VCR

Die vollständige Formatmatrix mit Details zu Lade- und Speicherunterstützung finden Sie in der Dokumentation.

Schnellstart

API-Anmeldeinformationen abrufen

Um GroupDocs.Metadata Cloud zu verwenden, registrieren Sie sich im GroupDocs.Cloud Dashboard und holen Sie sich Ihre Client ID und Ihr Client Secret.

API initialisieren

Verwenden Sie den folgenden Code, um mit der Verwendung des GroupDocs.Metadata Cloud SDK für Python zu beginnen:

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)

Metadaten aus einem Dokument extrahieren

Verwenden Sie nach der Initialisierung dieses einfache Beispiel, um Metadaten aus einer Datei im Cloud-Speicher zu extrahieren:

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

Mit dieser Kurzanleitung können Sie mit der Verwaltung von Metadaten mithilfe von GroupDocs.Metadata Cloud in Ihren Python-Anwendungen beginnen. Weitere Informationen finden Sie in der Dokumentation.

Unterstützte Dateiformate abrufen

Rufen Sie die vollständige Liste der über die Metadata API verfügbaren unterstützten Dateiformate ab.

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

Metadaten nach Tag extrahieren

Extrahieren Sie Metadaten-Eigenschaften, die einem bestimmten Tag in einem Dokument entsprechen.

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

Benutzerdefinierte Metadaten hinzufügen

Fügen Sie neue Metadaten-Eigenschaften zu einem Dokument mithilfe tagbasierter Suchkriterien hinzu.

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

Metadaten-Eigenschaften ändern

Aktualisieren Sie vorhandene Metadaten-Eigenschaften anhand von Tag-, Namen- oder Wert-Suchkriterien.

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

Metadaten-Eigenschaften entfernen

Entfernen Sie Metadaten-Eigenschaften aus einem Dokument basierend auf Suchkriterien.

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

Dokumentinformationen abrufen

Rufen Sie Dokumentdetails wie Format, Größe und Seitenanzahl ab, bevor Sie Metadaten verarbeiten.

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-Beispiele auf GitHub

Das GroupDocs.Metadata Cloud Python SDK-Repository enthält Unit-Tests und API-Nutzungsbeispiele im Ordner test/apis:

Weitere szenariobasierte Beispiele finden Sie im .NET-Beispiel-Repository.

So führen Sie die SDK-Tests aus

1. Klonen Sie das Python SDK-Repository
2. Installieren Sie Abhängigkeiten: pip install groupdocs-metadata-cloud
3. Konfigurieren Sie Anmeldeinformationen in test/test_settings.py
4. Führen Sie Tests im Repository-Stammverzeichnis aus: python -m unittest discover test

Weitere Informationen finden Sie unter Erste Schritte.

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