機密保護
IBM は、お客様やパートナーに、データ・プライバシー、セキュリティー、およびガバナンスに関する革新的なソリューションを提供することに努めています。
IBM Cloud IBM Cloud ただただ
この情報は、管理対象デプロイメントにのみ適用されます。
注意: お客様自身が欧州連合の一般データ保護規則を含む各種法令を遵守するために必要な措置を講ずるのはお客様の責任です。 お客様のビジネスに影響を与える可能性がある関連法規の確認と解釈、並びにかかる法規を遵守するためにお客様がとる必要のある措置に関して、弁護士の適切な助言を得ることはお客様のみにかかわる責任とさせていただきます。
本書に記載されている製品、サービス、その他の機能は、すべての顧客の状況に適しているわけではなく、利用が制限されている場合もあります。 IBM は法律上、会計上、または監査上の助言を提供することはしません。また、IBM のサービスまたは製品が、お客様のいかなる法規制の遵守を裏付けることも表明または保証することもありません。
作成された IBM Cloud® Watson リソースについて GDPR サポートを要請する必要がある場合は、GDPR サブジェクト・アクセス要求を参照してください。
EU 一般データ保護規則 (GDPR)
IBM は、お客様とパートナーの皆様に革新的なデータプライバシー、セキュリティ、ガバナンスソリューションを提供し、GDPR準拠への道のりを支援することをお約束します。
IBM のGDPRへの対応の歩みと、お客様のコンプライアンスへの対応をサポートする当社のGDPR対応能力とサービスについて、詳しく はこちらをご覧ください。
Discovery でのデータのラベル付けと削除
Discovery には、呼び出しごとにデータにラベルを付けるための API が含まれています。 API または Discovery 製品ユーザー・インターフェースのいずれかを使用してデータにラベルを付ける方法について詳しくは、 データのラベル付け を参照してください。
APIを使用して顧客データを削除することができます。 顧客データの削除に関する詳細は 、「ラベル付けされたデータの削除 」を参照してください。
実験的およびベータ版の機能は、本番環境での使用を目的としたものではなく、関連データをラベル付けして削除した場合に期待通りに機能することを保証するものではありません。 データのラベル付けや削除が必要なソリューションを実装する際には、実験的およびベータ版の機能を使用しないでください。
データのラベル付けをサポートするメソッド
customer_id が関連付けられた方法で情報を最初に追加した際に指定されていた場合、 customer_id を使用して以下の保存された情報を削除することができます
- キュレーション (
/v2/projects/{project_id}/curations) は、natural_language_query照会タイプでのみ使用可能です。 - 文書 (
/v2/projects/{project_id}/collections/{collection_id}/documents) - 通知 (
/v2/projects/{project_id}/notices) 取り込みnoticesのみにラベルが付けられます。 - トレーニング・データ (
/v2/projects/{project_id}/training_data/queries) - 辞書 ( Discovery 製品ユーザー・インターフェースで作成した場合のみ)
- エクスポートされた文書 (コンテンツ・マイニング・アプリケーションで作成された場合のみ)
- レポート (コンテンツ・マイニング・アプリケーションで作成された場合のみ)
エクスポートされた文書およびレポートは、コンテンツマイニングアプリケーションのリポジトリページおよびレポートページで閲覧できます。 APIを使用しても利用できません。
Discovery は、照会要求データをログに記録しません。
Discoveryでデータにラベルを付けるためのオプションについて詳しくは、 データのラベル付け を参照してください。
以下の保管された情報は明示的にラベル付けされず、customer_id を指定して削除することはできません。 これらのフィールドでは個人データはサポートされていません。
以下の保管項目のストリング・フィールド (name および description を含みますが、これに限定されるものではありません) が該当します。
- コレクション
- プロジェクト
データのラベル付け
API を使用するか、 Discovery 製品ユーザー・インターフェースを使用して、データにラベルを付けることができます。 製品ユーザー・インターフェースを使用したラベル付けについて詳しくは、 製品ユーザー・インターフェースでのデータのラベル付け を参照してください。
外部データ・ソースのクロールによって追加されたデータにラベルを付けることはできません。
オプションの X-Watson-Metadata ヘッダーに任意の customer_id を追加することにより、データにラベルが付けられます。 Discovery は、 customer_id によってそれを削除できます。
以下のように、さまざまな方法で API を使用してデータにラベルを付けることができます。
-
POST /v2/projects/{project_id}/collections/{collection_id}/documentsまたはPOST /v2/projects/{project_id}/collections/{collection_id}/documents/ID操作を使用してドキュメントをインポートする際には、オプションのヘッダーX-Watson-Metadataを送信してください。X-Watson-Metadataヘッダーには、以下のいずれかの項目を含める必要があります。- セミコロンで区切られた
field=valueのペア (例:customer_id=123) customer_idフィールド。 そのcustomer_idをX-Watson-Metadataヘッダーに追加することにより、要求には、このcustomer_idに属するデータが含まれていることが示されます。
- セミコロンで区切られた
オプションとして、 X-Watson-Metadata ヘッダーを含める代わりに、 metadata マルチパートフォームパートに customer_id フィールドを含めることもできます。
metadata のマルチパート形式のパートで customer_id を指定し、同じドキュメントの X-Watson-Metadata ヘッダーを指定した場合、 X-Watson-Metadata ヘッダーの customer_id が使用されます。
次の例では、customer_id ヘッダーと X-Watson-Metadata の両方に metadata を追加しています。
curl -k -u "apikey:$API_KEY" \
-H "x-watson-userinfo:instance-id=asdf" \
-H "x-watson-metadata:customer_id=customer_header_123" \
-H "x-watson-discovery-next:true" \
-F "file=@$FILENAME" \
-F "metadata={\"customer_id\": \"new123\"}" \
-X POST "$API_URL/v2/projects/$PROJECT_ID/collections/$COLLECTION_ID/documents?version=2020-03-08" \
出力例:
{
"document_id":"8b152926-e9f5-4f34-940a-c02da7ef3af4",
"result_metadata":{
"collection_id":"24265c0b-2a55-3ccf-0000-017334467b6e"
},
"metadata":{
"date":1594319812384,
"parent_document_id":"8b152926-e9f5-4f34-940a-c02da7ef3af4",
"customer_id":"customer_header_123"
},
"extracted_metadata":{
"sha1":"CEC7C1D3423C7D4ED58FC448F52681ECA93CED8A",
"numPages":"1",
"filename":"Simple.pdf",
"author":[
"Simple Man"
],
"subject":"Simple Metadata",
"file_type":"pdf",
"title":"Simple Title",
"publicationdate":"2016-10-05"
}
}
文書が既に取り込まれている場合は、もう一度取り込んで X-Watson-Metadata ヘッダーと customer_id を追加する必要があります。
制約:
X-Watson-Metadataヘッダーの値は、テキストで4KBを超えてはなりません。X-Watson-Metadataヘッダーには、field=valueのペアをセミコロンで区切ったリストを含める必要があります。fieldとvalueには、セミコロン (;) または等号 (=) を含めることはできません。customer_idは、各 Discovery インスタンス内で固有です。 これらは、プロジェクトまたはコレクションごとに固有ではありません。customer_idの長さは 256 文字を超えることはできません。customer_idが空白のみの場合、または空の場合、customer_idがまったく指定されていないものとして処理され、エラーメッセージは返されません。
製品ユーザー・インターフェースでのデータのラベル付け
Discovery 製品ユーザー・インターフェースを使用するか、API を使用して、データにラベルを付けることができます。 API を使用したラベル付けについて詳しくは、データのラベル付けを参照してください。
製品ユーザー・インターフェースでデータにラベルを付けるには、以下のようにします。
- **「マイ・プロジェクト」を選択して「プロジェクト」**ページを開きます。
- **「データの使用と GDPR (Data usage and GDPR)」**を選択します。
- **「GDPR データ・ラベル」**タブを選択します。
- **「データに顧客 ID をラベル付けする (Label data with customer ID)」**トグルを
onに設定します。 **「顧客 ID (Customer ID)」**フィールドが表示されます。 - 「顧客 ID (Customer ID)」フィールドに顧客の固有 ID を入力します。 個人データを顧客 ID に含めないでください。
- **「ID の保存 (Save ID)」**をクリックします。
顧客ID ( customer_id )フィールドが設定されると、現在のブラウザセッション中にアップロードされたすべてのデータに、指定された顧客ID が付けられます。 (外部データ・ソースのクロールによって追加されたデータにラベルを付けることはできません。)
顧客 ID を追加すると、その時点から、URL ドメイン内の文書、通知、辞書、トレーニング・データが、そのドメインでの各インスタンスも含めて、ラベル付けされます。 顧客IDフィールドが追加される前に Discovery 製品のユーザーインターフェースで発生したドキュメントのアップロードを含むすべてのアクションにはラベルが付けられていません。
Discovery の製品ユーザーインターフェースを使用してカスタマーID を指定した後、ドメインまたはブラウザを切り替えたり、ブラウザのキャッシュを消去したり、シークレットウィンドウでセッションを開始したりすると、 カスタマーID は保持されず、お客様のデータにはラベルが付けられません。 どうしてもドメインやブラウザを切り替える必要がある場合は、切り替え後に GDPRデータラベルタブを開き、 顧客ID を再度入力し、 IDを保存をクリックします。
既存の顧客 ID を変更する必要がある場合は、以下のようにします。
- その顧客 ID に関連付けられたデータを削除します。 手順については、ラベル付きデータの削除を参照してください。
- Discovery 製品ユーザー・インターフェースで、または API を使用して、データにラベルを付ける手順に従います。
- データをアップロードまたはクロールします。
ラベル付きデータの削除
customer_id というラベルが付けられた顧客データは、APIを使用して削除することができます。 API または Discovery 製品ユーザー・インターフェースのいずれかを使用してデータにラベルを付ける方法について詳しくは、 データのラベル付け を参照してください。
Discovery 製品ユーザー・インターフェースからラベル付きデータを削除することはできません。
DELETE /v2/user_data操作を使用し、削除したいデータのcustomer_idを指定してください。DELETE /v2/user_dataそのサービスインスタンス内の特定の に関連付けられているすべてのデータを削除します。customer_idラベル付けされたデータをサポートするメソッド で指定されているとおりです。 また 、APIリファレンスの 「ラベル付きデータの削除」 も参照してください
- すべてのラベル付きコンテンツが正しく削除されるようにするには、コレクションの
processingカウントとpendingカウントが0を返した後にDELETE /v2/user_data操作を実行します。
ラベル付きデータの削除に関する注意事項:
- 削除は非同期的に行われます。 削除の進行状況は追跡できません。
- 存在しない
customer_idが指定された場合、何も削除されませんが、202 - Acceptedの応答が返されます。 - プロジェクトまたはコレクションを作成する要求に
customer_idヘッダーが含まれていても、プロジェクトおよびコレクションにはX-Watson-Metadataのラベルが付けられません。 コレクション内の個々の文書のみにラベルが付けられます。 したがって、データを削除しても、個々のプロジェクトやコレクションは削除されません。