不適切なコンテンツの検出は、動画内のアダルト コンテンツを検出します。通常、アダルト コンテンツは 18 歳未満には不適切なもので、ヌード、性的描写、ポルノなどを指します(ただし、これらに限定されません)。このようなコンテンツは、漫画やアニメでも検出されます。
レスポンスには、バケット化された可能性の値(VERY_UNLIKELY
から VERY_LIKELY
まで)が含まれます。
不適切なコンテンツの検出で動画を評価すると、フレーム単位で分析が実行されます。評価されるのはビジュアル コンテンツのみです。動画の音声部分は、不適切なコンテンツのレベルが評価されません。
Cloud Storage にあるファイルに対して、不適切なコンテンツの検出機能について動画分析を行う例を次に示します。
REST
動画アノテーションリクエストを送信する
POST リクエストを videos:annotate
メソッドに送信する方法を以下に示します。この例では、Google Cloud CLI を使用してアクセス トークンを生成します。gcloud CLI のインストール手順については、Video Intelligence API のクイックスタートをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
- INPUT_URI: アノテーションを付けるファイルを含む Cloud Storage バケット(ファイル名を含む)。
gs://
で始まる必要があります。
例:"inputUri": "gs://cloud-videointelligence-demo/assistant.mp4",
- PROJECT_NUMBER: Google Cloud プロジェクトの数値識別子。
HTTP メソッドと URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
JSON 本文のリクエスト:
{ "inputUri": "INPUT_URI", "features": ["EXPLICIT_CONTENT_DETECTION"] }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID" }
レスポンスが成功すると、Video Intelligence API はオペレーションの name
を返します。上記は、このようなレスポンスの例です。
- PROJECT_NUMBER: プロジェクトの数
- LOCATION_ID: アノテーションを実行する Cloud リージョン。サポート対象のクラウド リージョンは
us-east1
、us-west1
、europe-west1
、asia-east1
です。リージョンを指定しないと、動画ファイルの場所に基づいてリージョンが決まります。 - OPERATION_ID: リクエストに対して作成され、オペレーション開始時にレスポンスで指定された長時間実行オペレーションの ID(例:
12345...
)
アノテーションの結果を取得する
オペレーションの結果を取得するには、次の例のように、videos:annotate
の呼び出しから返されたオペレーション名を使用して GET リクエストを行います。
データをリクエストする前に、次のように置き換えます。
- OPERATION_NAME: Video Intelligence API によって返されるオペレーションの名前。オペレーション名の形式は
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
です。 - PROJECT_NUMBER: Google Cloud プロジェクトの数値識別子。
HTTP メソッドと URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoProgress", "annotationProgress": [ { "inputUri": "/demomaker/gbikes_dinosaur.mp4", "progressPercent": 100, "startTime": "2020-03-26T00:16:35.112404Z", "updateTime": "2020-03-26T00:16:55.937889Z" } ] }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoResponse", "annotationResults": [ { "inputUri": "/demomaker/gbikes_dinosaur.mp4", "explicitAnnotation": { "frames": [ { "timeOffset": "0.056149s", "pornographyLikelihood": "VERY_UNLIKELY" }, { "timeOffset": "1.166841s", "pornographyLikelihood": "VERY_UNLIKELY" }, ... { "timeOffset": "41.678209s", "pornographyLikelihood": "VERY_UNLIKELY" }, { "timeOffset": "42.596413s", "pornographyLikelihood": "VERY_UNLIKELY" } ] } } ] } }
shotAnnotations
リストとして返されます。
注: done フィールドは、値が True の場合にのみ返されます。オペレーションが完了していない場合、レスポンスには含まれません。
アノテーションの結果をダウンロードする
アノテーションを、送信元バケットから送信先バケットにコピーします(ファイルとオブジェクトのコピーをご覧ください)。
gcloud storage cp gcs_uri gs://my-bucket
注: 出力 GCS URI がユーザーによって指定された場合、アノテーションはその GCS URI に格納されます。
Go
Java
Video Intelligence への認証を行うには、アプリケーションのデフォルト認証情報を設定します。 詳細については、ローカル開発環境の認証を設定するをご覧ください。
Node.js
Video Intelligence への認証を行うには、アプリケーションのデフォルト認証情報を設定します。 詳細については、ローカル開発環境の認証を設定するをご覧ください。
Python
Python 用の Cloud Video Intelligence API クライアント ライブラリのインストールと使用方法については、Cloud Video Intelligence API クライアント ライブラリをご覧ください。その他の言語
C#: クライアント ライブラリ ページの C# の設定手順を実行してから、.NET の Video Intelligence のリファレンス ドキュメントをご覧ください。
PHP: クライアント ライブラリ ページの PHP の設定手順を実行してから、PHP の Video Intelligence のリファレンス ドキュメントをご覧ください。
Ruby: クライアント ライブラリ ページの Ruby の設定手順を実行してから、Ruby の Video Intelligence のリファレンス ドキュメントをご覧ください。