不適切なコンテンツを検出する（セーフサーチ）

Google Cloud プロジェクトをまだ作成していない場合は、ここで作成します。このセクションを開いて手順を確認してください。

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Enable the Vision API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the API

4. Install the Google Cloud CLI.

5. 連携 ID を使用するように gcloud CLI を構成します。

   詳細については、連携 ID を使用して gcloud CLI にログインするをご覧ください。

6. gcloud CLI を初期化するには、次のコマンドを実行します。

   gcloud init

   ローカル画像での露骨な表現を含むコンテンツの検出

   Vision API を使用して、ローカル画像ファイルに特徴検出を実行できます。

   REST リクエストの場合は、リクエストの本文で画像ファイルのコンテンツを base64 エンコード文字列として送信します。

   gcloud とクライアント ライブラリ リクエストの場合は、リクエストにローカル イメージへのパスを指定します。

   REST

   リクエストのデータを使用する前に、次のように置き換えます。

   • BASE64_ENCODED_IMAGE: バイナリ画像データの base64 表現（ASCII 文字列）。これは次のような文字列になります。
     • /9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
     詳細については、base64 エンコードをご覧ください。
   • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

   HTTP メソッドと URL:

   POST https://vision.googleapis.com/v1/images:annotate

   リクエストの本文（JSON）:

   {
     "requests": [
       {
         "image": {
           "content": "BASE64_ENCODED_IMAGE"
         },
         "features": [
           {
             "type": "SAFE_SEARCH_DETECTION"
           },
         ]
       }
     ]
   }
   

   リクエストを送信するには、次のいずれかのオプションを選択します。

   curl

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "x-goog-user-project: PROJECT_ID" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://vision.googleapis.com/v1/images:annotate"

   PowerShell

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://vision.googleapis.com/v1/images:annotate" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   {
     "responses": [
       {
         "safeSearchAnnotation": {
           "adult": "UNLIKELY",
           "spoof": "VERY_UNLIKELY",
           "medical": "VERY_UNLIKELY",
           "violence": "LIKELY",
           "racy": "POSSIBLE"
         }
       }
     ]
   }
   

   Go

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Go の設定を完了してください。 詳細については、Vision Go API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   
   // detectSafeSearch gets image properties from the Vision API for an image at the given file path.
   func detectSafeSearch(w io.Writer, file string) error {
   	ctx := context.Background()
   
   	client, err := vision.NewImageAnnotatorClient(ctx)
   	if err != nil {
   		return err
   	}
   
   	f, err := os.Open(file)
   	if err != nil {
   		return err
   	}
   	defer f.Close()
   
   	image, err := vision.NewImageFromReader(f)
   	if err != nil {
   		return err
   	}
   	props, err := client.DetectSafeSearch(ctx, image, nil)
   	if err != nil {
   		return err
   	}
   
   	fmt.Fprintln(w, "Safe Search properties:")
   	fmt.Fprintln(w, "Adult:", props.Adult)
   	fmt.Fprintln(w, "Medical:", props.Medical)
   	fmt.Fprintln(w, "Racy:", props.Racy)
   	fmt.Fprintln(w, "Spoofed:", props.Spoof)
   	fmt.Fprintln(w, "Violence:", props.Violence)
   
   	return nil
   }
   

   Java

   このサンプルを試す前に、Vision API クイックスタート: クライアント ライブラリの使用にある Java の設定を完了してください。詳細については、Vision API Java のリファレンス ドキュメントをご覧ください。

   
   import com.google.cloud.vision.v1.AnnotateImageRequest;
   import com.google.cloud.vision.v1.AnnotateImageResponse;
   import com.google.cloud.vision.v1.BatchAnnotateImagesResponse;
   import com.google.cloud.vision.v1.Feature;
   import com.google.cloud.vision.v1.Image;
   import com.google.cloud.vision.v1.ImageAnnotatorClient;
   import com.google.cloud.vision.v1.SafeSearchAnnotation;
   import com.google.protobuf.ByteString;
   import java.io.FileInputStream;
   import java.io.IOException;
   import java.util.ArrayList;
   import java.util.List;
   
   public class DetectSafeSearch {
     public static void detectSafeSearch() throws IOException {
       // TODO(developer): Replace these variables before running the sample.
       String filePath = "path/to/your/image/file.jpg";
       detectSafeSearch(filePath);
     }
   
     // Detects whether the specified image has features you would want to moderate.
     public static void detectSafeSearch(String filePath) throws IOException {
       List<AnnotateImageRequest> requests = new ArrayList<>();
   
       ByteString imgBytes = ByteString.readFrom(new FileInputStream(filePath));
   
       Image img = Image.newBuilder().setContent(imgBytes).build();
       Feature feat = Feature.newBuilder().setType(Feature.Type.SAFE_SEARCH_DETECTION).build();
       AnnotateImageRequest request =
           AnnotateImageRequest.newBuilder().addFeatures(feat).setImage(img).build();
       requests.add(request);
   
       // Initialize client that will be used to send requests. This client only needs to be created
       // once, and can be reused for multiple requests. After completing all of your requests, call
       // the "close" method on the client to safely clean up any remaining background resources.
       try (ImageAnnotatorClient client = ImageAnnotatorClient.create()) {
         BatchAnnotateImagesResponse response = client.batchAnnotateImages(requests);
         List<AnnotateImageResponse> responses = response.getResponsesList();
   
         for (AnnotateImageResponse res : responses) {
           if (res.hasError()) {
             System.out.format("Error: %s%n", res.getError().getMessage());
             return;
           }
   
           // For full list of available annotations, see http://g.co/cloud/vision/docs
           SafeSearchAnnotation annotation = res.getSafeSearchAnnotation();
           System.out.format(
               "adult: %s%nmedical: %s%nspoofed: %s%nviolence: %s%nracy: %s%n",
               annotation.getAdult(),
               annotation.getMedical(),
               annotation.getSpoof(),
               annotation.getViolence(),
               annotation.getRacy());
         }
       }
     }
   }

   Node.js

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Node.js の設定を完了してください。詳細については、Vision Node.js API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   const vision = require('@google-cloud/vision');
   
   // Creates a client
   const client = new vision.ImageAnnotatorClient();
   
   /**
    * TODO(developer): Uncomment the following line before running the sample.
    */
   // const fileName = 'Local image file, e.g. /path/to/image.png';
   
   // Performs safe search detection on the local file
   const [result] = await client.safeSearchDetection(fileName);
   const detections = result.safeSearchAnnotation;
   console.log('Safe search:');
   console.log(`Adult: ${detections.adult}`);
   console.log(`Medical: ${detections.medical}`);
   console.log(`Spoof: ${detections.spoof}`);
   console.log(`Violence: ${detections.violence}`);
   console.log(`Racy: ${detections.racy}`);

   Python

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Python の設定を完了してください。詳細については、Vision Python API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   def detect_safe_search(path):
       """Detects unsafe features in the file."""
       from google.cloud import vision
   
       client = vision.ImageAnnotatorClient()
   
       with open(path, "rb") as image_file:
           content = image_file.read()
   
       image = vision.Image(content=content)
   
       response = client.safe_search_detection(image=image)
       safe = response.safe_search_annotation
   
       # Names of likelihood from google.cloud.vision.enums
       likelihood_name = (
           "UNKNOWN",
           "VERY_UNLIKELY",
           "UNLIKELY",
           "POSSIBLE",
           "LIKELY",
           "VERY_LIKELY",
       )
       print("Safe search:")
   
       print(f"adult: {likelihood_name[safe.adult]}")
       print(f"medical: {likelihood_name[safe.medical]}")
       print(f"spoofed: {likelihood_name[safe.spoof]}")
       print(f"violence: {likelihood_name[safe.violence]}")
       print(f"racy: {likelihood_name[safe.racy]}")
   
       if response.error.message:
           raise Exception(
               "{}\nFor more info on error messages, check: "
               "https://cloud.google.com/apis/design/errors".format(response.error.message)
           )
   
   

   リモート画像での露骨な表現を含むコンテンツの検出

   Vision API を使用すると、Cloud Storage またはウェブ上にあるリモート画像ファイルに特徴検出を実行できます。リモート ファイル リクエストを送信するには、リクエストの本文でファイルのウェブ URL または Cloud Storage URI を指定します。

   REST

   リクエストのデータを使用する前に、次のように置き換えます。

   • CLOUD_STORAGE_IMAGE_URI: Cloud Storage バケット内の有効な画像ファイルへのパス。少なくとも、ファイルに対する読み取り権限が必要です。例:
     • gs://my-storage-bucket/img/image1.png

   • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

   HTTP メソッドと URL:

   POST https://vision.googleapis.com/v1/images:annotate

   リクエストの本文（JSON）:

   {
     "requests": [
       {
         "image": {
           "source": {
             "imageUri": "CLOUD_STORAGE_IMAGE_URI"
           }
         },
         "features": [
           {
             "type": "SAFE_SEARCH_DETECTION"
           }
         ]
       }
     ]
   }
   

   リクエストを送信するには、次のいずれかのオプションを選択します。

   curl

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "x-goog-user-project: PROJECT_ID" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://vision.googleapis.com/v1/images:annotate"

   PowerShell

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://vision.googleapis.com/v1/images:annotate" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   {
     "responses": [
       {
         "safeSearchAnnotation": {
           "adult": "UNLIKELY",
           "spoof": "VERY_UNLIKELY",
           "medical": "VERY_UNLIKELY",
           "violence": "LIKELY",
           "racy": "POSSIBLE"
         }
       }
     ]
   }
   

   Go

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Go の設定を完了してください。 詳細については、Vision Go API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   
   // detectSafeSearch gets image properties from the Vision API for an image at the given file path.
   func detectSafeSearchURI(w io.Writer, file string) error {
   	ctx := context.Background()
   
   	client, err := vision.NewImageAnnotatorClient(ctx)
   	if err != nil {
   		return err
   	}
   
   	image := vision.NewImageFromURI(file)
   	props, err := client.DetectSafeSearch(ctx, image, nil)
   	if err != nil {
   		return err
   	}
   
   	fmt.Fprintln(w, "Safe Search properties:")
   	fmt.Fprintln(w, "Adult:", props.Adult)
   	fmt.Fprintln(w, "Medical:", props.Medical)
   	fmt.Fprintln(w, "Racy:", props.Racy)
   	fmt.Fprintln(w, "Spoofed:", props.Spoof)
   	fmt.Fprintln(w, "Violence:", props.Violence)
   
   	return nil
   }
   

   Java

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Java の設定を完了してください。詳細については、Vision Java API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   
   import com.google.cloud.vision.v1.AnnotateImageRequest;
   import com.google.cloud.vision.v1.AnnotateImageResponse;
   import com.google.cloud.vision.v1.BatchAnnotateImagesResponse;
   import com.google.cloud.vision.v1.Feature;
   import com.google.cloud.vision.v1.Feature.Type;
   import com.google.cloud.vision.v1.Image;
   import com.google.cloud.vision.v1.ImageAnnotatorClient;
   import com.google.cloud.vision.v1.ImageSource;
   import com.google.cloud.vision.v1.SafeSearchAnnotation;
   import java.io.IOException;
   import java.util.ArrayList;
   import java.util.List;
   
   public class DetectSafeSearchGcs {
   
     public static void detectSafeSearchGcs() throws IOException {
       // TODO(developer): Replace these variables before running the sample.
       String filePath = "gs://your-gcs-bucket/path/to/image/file.jpg";
       detectSafeSearchGcs(filePath);
     }
   
     // Detects whether the specified image on Google Cloud Storage has features you would want to
     // moderate.
     public static void detectSafeSearchGcs(String gcsPath) throws IOException {
       List<AnnotateImageRequest> requests = new ArrayList<>();
   
       ImageSource imgSource = ImageSource.newBuilder().setGcsImageUri(gcsPath).build();
       Image img = Image.newBuilder().setSource(imgSource).build();
       Feature feat = Feature.newBuilder().setType(Type.SAFE_SEARCH_DETECTION).build();
       AnnotateImageRequest request =
           AnnotateImageRequest.newBuilder().addFeatures(feat).setImage(img).build();
       requests.add(request);
   
       // Initialize client that will be used to send requests. This client only needs to be created
       // once, and can be reused for multiple requests. After completing all of your requests, call
       // the "close" method on the client to safely clean up any remaining background resources.
       try (ImageAnnotatorClient client = ImageAnnotatorClient.create()) {
         BatchAnnotateImagesResponse response = client.batchAnnotateImages(requests);
         List<AnnotateImageResponse> responses = response.getResponsesList();
   
         for (AnnotateImageResponse res : responses) {
           if (res.hasError()) {
             System.out.format("Error: %s%n", res.getError().getMessage());
             return;
           }
   
           // For full list of available annotations, see http://g.co/cloud/vision/docs
           SafeSearchAnnotation annotation = res.getSafeSearchAnnotation();
           System.out.format(
               "adult: %s%nmedical: %s%nspoofed: %s%nviolence: %s%nracy: %s%n",
               annotation.getAdult(),
               annotation.getMedical(),
               annotation.getSpoof(),
               annotation.getViolence(),
               annotation.getRacy());
         }
       }
     }
   }

   Node.js

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Node.js の設定を完了してください。詳細については、Vision Node.js API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   // Imports the Google Cloud client libraries
   const vision = require('@google-cloud/vision');
   
   // Creates a client
   const client = new vision.ImageAnnotatorClient();
   
   /**
    * TODO(developer): Uncomment the following lines before running the sample.
    */
   // const bucketName = 'Bucket where the file resides, e.g. my-bucket';
   // const fileName = 'Path to file within bucket, e.g. path/to/image.png';
   
   // Performs safe search property detection on the remote file
   const [result] = await client.safeSearchDetection(
     `gs://${bucketName}/${fileName}`
   );
   const detections = result.safeSearchAnnotation;
   console.log(`Adult: ${detections.adult}`);
   console.log(`Spoof: ${detections.spoof}`);
   console.log(`Medical: ${detections.medical}`);
   console.log(`Violence: ${detections.violence}`);

   Python

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Python の設定を完了してください。詳細については、Vision Python API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   def detect_safe_search_uri(uri):
       """Detects unsafe features in the file located in Google Cloud Storage or
       on the Web."""
       from google.cloud import vision
   
       client = vision.ImageAnnotatorClient()
       image = vision.Image()
       image.source.image_uri = uri
   
       response = client.safe_search_detection(image=image)
       safe = response.safe_search_annotation
   
       # Names of likelihood from google.cloud.vision.enums
       likelihood_name = (
           "UNKNOWN",
           "VERY_UNLIKELY",
           "UNLIKELY",
           "POSSIBLE",
           "LIKELY",
           "VERY_LIKELY",
       )
       print("Safe search:")
   
       print(f"adult: {likelihood_name[safe.adult]}")
       print(f"medical: {likelihood_name[safe.medical]}")
       print(f"spoofed: {likelihood_name[safe.spoof]}")
       print(f"violence: {likelihood_name[safe.violence]}")
       print(f"racy: {likelihood_name[safe.racy]}")
   
       if response.error.message:
           raise Exception(
               "{}\nFor more info on error messages, check: "
               "https://cloud.google.com/apis/design/errors".format(response.error.message)
           )
   
   

   gcloud

   セーフサーチ検出を実行するには、次の例のように gcloud ml vision detect-safe-search コマンドを実行します。

   gcloud ml vision detect-safe-search gs://my_bucket/input_file