メタデータクラウド API | GroupDocs.メタデータ

製品を閲覧する

Are you looking for an evaluation version of a product?

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.

Are you having troubles in downloading?

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.

インストール
パッケージは、availablePyPI にあり、経由でインストールできますpip次のコマンドを実行します。
pip install groupdocs-metadata-cloud

要件

Python 3.4+
pip パッケージマネージャー
GroupDocs クラウド認証情報 —Client ID and Client Secretダッシュボードから

依存関係

SDK は次のパッケージを自動的にインストールします。

パッケージ	制約
urllib3	>= 1.15
six	>= 1.10
certifi	—
python-dateutil	—

クイックスタート

API 認証情報を取得する

GroupDocs.Metadata Cloud を使用するには、次の URL でサインアップしてください。GroupDocs.Cloud Dashboardクライアント ID と クライアントシークレット を取得します。

API を初期化する

GroupDocs.Metadata Cloud SDK for 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)

ドキュメントからメタデータを抽出する

初期化したら、次の基本的な例を使用して、クラウドストレージ内のファイルからメタデータを抽出します。

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

このクイックスタートガイドを使用すると、Python アプリケーションで GroupDocs.Metadata Cloud を使用してメタデータの管理を開始する準備が整います。詳細については、次のサイトを参照してください。documentation.

サポートされているファイル形式を取得する

メタデータ 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))

タグによるメタデータの抽出

特定のタグに一致するメタデータプロパティをドキュメントから抽出します。

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

カスタムメタデータを追加する

タグベースの検索条件を使用して、新しいメタデータプロパティをドキュメントに追加します。

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

メタデータのプロパティを変更する

タグ、名前、または値の検索基準によって既存のメタデータプロパティを更新します。

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

メタデータプロパティを削除する

検索基準に基づいてドキュメントからメタデータプロパティを削除します。

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

ドキュメント情報の取得

メタデータを処理する前に、形式、サイズ、ページ数などのドキュメントの詳細を取得します。

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

GitHub の SDK サンプル

のGroupDocs.Metadata Cloud Python SDKリポジトリには、単体テストと API の使用例が含まれています。test/apisフォルダ：

カテゴリー	例
メタデータ操作	タグ、名前、値によるメタデータの抽出、追加、設定、削除
情報操作	サポートされているファイル形式、ドキュメント情報
ストレージとファイル	ストレージAPI、ファイルアップロード/ダウンロード、フォルダー管理
認証	API の構成と認証

追加のシナリオベースの例は、.NET samples repository.

SDK テストの実行方法

クローンを作成します。Python SDK repository2. 依存関係をインストールします。pip install groupdocs-metadata-cloud3. で認証情報を設定します。test/test_settings.py4. リポジトリのルートからテストを実行します。python -m unittest discover test

詳細については、次のサイトをご覧ください。Getting Started.