Content Moderation:Document Moderation 2.0 SDK and integration guide

Detect publicly accessible documents

Scenario

If the document that you want to moderate is accessible from the Internet, Document Moderation 2.0 retrieves the file using the document URL and then moderates the file.

To use the SDK in a Maven project, add the required dependencies to the pom.xml file.

1. Add the following dependencies to the dependencies section:

   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>green20220302</artifactId>
     <version>2.2.11</version>
   </dependency>

2. Integrate the Java SDK.

   • Sample code for submitting a document detection task

     import com.alibaba.fastjson.JSON;
     import com.alibaba.fastjson.JSONObject;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.FileModerationRequest; 
     import com.aliyun.green20220302.models.FileModerationResponse; 
     import com.aliyun.green20220302.models.FileModerationResponseBody; 
     import com.aliyun.teaopenapi.models.Config;
     
     public class FileModerationDemo {
         public static void main(String[] args) throws Exception {
             Config config = new Config();
              /**
              * The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
              * Common methods to obtain environment variables:
              * Method 1:
              *     Obtain the RAM user AccessKey ID: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * Method 2:
              *     Obtain the RAM user AccessKey ID: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("It is recommended to obtain the RAM user AccessKey ID from environment variables");
             config.setAccessKeySecret("It is recommended to obtain the RAM user AccessKey Secret from environment variables");
             // Modify the region and address based on actual conditions.
             config.setRegionId("ap-southeast-1");
             config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
             // Connection timeout in milliseconds (ms).
             config.setReadTimeout(6000);
             // Read timeout in milliseconds (ms).
             config.setConnectTimeout(3000);
     
             Client client = new Client(config);
             JSONObject serviceParameters = new JSONObject();
             serviceParameters.put("url", "https://xxx.oss.aliyuncs.com/xxx.pdf"); // File URL
     
             FileModerationRequest fileModerationRequest = new FileModerationRequest(); 
             // Detection type: document_detection_global general document detection
             fileModerationRequest.setService("document_detection_global");
             fileModerationRequest.setServiceParameters(serviceParameters.toJSONString());
     
             try {
                 FileModerationResponse response = client.fileModeration(fileModerationRequest); 
                 if (response.getStatusCode() == 200) {
                     FileModerationResponseBody result = response.getBody(); 
                     System.out.println(JSON.toJSONString(result));
                     System.out.println("requestId = " + result.getRequestId());
                     System.out.println("code = " + result.getCode());
                     System.out.println("msg = " + result.getMessage());
                     Integer code = result.getCode();
                     if (200 == code) {
                         FileModerationResponseBody.FileModerationResponseBodyData data = result.getData();
                         System.out.println("taskId = [" + data.getTaskId() + "]");
                     } else {
                         System.out.println("file moderation not success. code:" + code);
                     }
                 } else {
                     System.out.println("response not success. status:" + response.getStatusCode());
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }
     

   • Retrieve document detection task results

     import com.alibaba.fastjson.JSON;
     import com.alibaba.fastjson.JSONObject;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.DescribeFileModerationResultRequest;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponse;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponseBody;
     import com.aliyun.teaopenapi.models.Config;
     
     
     public class DescribeFileModerationResultDemo {
     
         public static void main(String[] args) throws Exception {
             Config config = new Config();
             /**
              * The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
              * Common methods to obtain environment variables:
              * Method 1:
              *     Obtain the RAM user AccessKey ID: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * Method 2:
              *     Obtain the RAM user AccessKey ID: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("It is recommended to obtain the RAM user AccessKey ID from environment variables");
             config.setAccessKeySecret("It is recommended to obtain the RAM user AccessKey Secret from environment variables");
             // Modify the region and address based on actual conditions
             config.setRegionId("ap-southeast-1");
             config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
             // Connection timeout in milliseconds (ms).
             config.setReadTimeout(6000);
             // Read timeout in milliseconds (ms).
             config.setConnectTimeout(3000);
           
             Client client = new Client(config);
     
             JSONObject serviceParameters = new JSONObject();
             // taskId returned when the task is submitted
             serviceParameters.put("taskId", "fi_f_O5z5i*********-1xxp0V");
     
     
             DescribeFileModerationResultRequest describeFileModerationResultRequest = new DescribeFileModerationResultRequest();
             
             describeFileModerationResultRequest.setService("document_detection_global");
             describeFileModerationResultRequest.setServiceParameters(serviceParameters.toJSONString());
     
             try {
                 DescribeFileModerationResultResponse response = client.describeFileModerationResult(describeFileModerationResultRequest);
                 if (response.getStatusCode() == 200) {
                     DescribeFileModerationResultResponseBody result = response.getBody();
                     System.out.println("requestId=" + result.getRequestId());
                     System.out.println("code=" + result.getCode());
                     System.out.println("msg=" + result.getMessage());
                     if (200 == result.getCode()) {
                         DescribeFileModerationResultResponseBody.DescribeFileModerationResultResponseBodyData data = result.getData();
                         System.out.println("pageResult = " + JSON.toJSONString(data.getPageResult()));
                         System.out.println("dataId = " + data.getDataId());
                         System.out.println("url = " + data.getUrl());
                     } else {
                         System.out.println("file moderation result not success. code:" + result.getCode());
                     }
                 } else {
                     System.out.println("response not success. status:" + response.getStatusCode());
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }

Detect local documents

Scenario

If the document that you want to moderate is stored locally and is not accessible from the Internet, you must upload it to an Object Storage Service (OSS) bucket that is provided by Content Moderation. Document Moderation 2.0 then directly accesses OSS to retrieve and moderate the document content.

1. Add the following dependencies to the dependencies section:

   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>green20220302</artifactId>
     <version>2.2.11</version>
   </dependency>

   Install the OSS SDK:

   <dependency>
     <groupId>com.aliyun.oss</groupId>
     <artifactId>aliyun-sdk-oss</artifactId>
     <version>3.16.3</version>
   </dependency>

2. Integrate the Java SDK.

   • Sample code for submitting a document detection task

     import com.alibaba.fastjson.JSON;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.DescribeUploadTokenResponse;
     import com.aliyun.green20220302.models.DescribeUploadTokenResponseBody;
     import com.aliyun.green20220302.models.FileModerationRequest;
     import com.aliyun.green20220302.models.FileModerationResponse;
     import com.aliyun.green20220302.models.FileModerationResponseBody;
     import com.aliyun.oss.OSS;
     import com.aliyun.oss.OSSClientBuilder;
     import com.aliyun.oss.model.PutObjectRequest;
     import com.aliyun.teaopenapi.models.Config;
     import com.aliyun.teautil.models.RuntimeOptions;
     
     import java.io.File;
     import java.util.HashMap;
     import java.util.Map;
     import java.util.UUID;
     
     public class FileModerationFile {
         /**Whether the service is deployed on vpc*/
         public static boolean isVPC = false;
     
         /**File upload token endpoint->token*/
         public static Map<String, DescribeUploadTokenResponseBody.DescribeUploadTokenResponseBodyData> tokenMap = new HashMap<>();
     
         /**Client for uploading file requests*/
         public static OSS ossClient = null;
     
         /**
          * Create a request client
          *
          * @param accessKeyId
          * @param accessKeySecret
          * @param endpoint
          * @return
          * @throws Exception
          */
         public static Client createClient(String accessKeyId, String accessKeySecret, String endpoint) throws Exception {
             Config config = new Config();
             config.setAccessKeyId(accessKeyId);
             config.setAccessKeySecret(accessKeySecret);
             // Modify the region and address based on actual conditions
             config.setEndpoint(endpoint);
             return new Client(config);
         }
     
         /**
          * Create a client for uploading file requests
          *
          * @param tokenData
          * @param isVPC
          */
         public static void getOssClient(DescribeUploadTokenResponseBody.DescribeUploadTokenResponseBodyData tokenData, boolean isVPC) {
             // Note that the instantiated client here should be reused as much as possible to avoid repeated connections and improve detection performance.
             if (isVPC) {
                 ossClient = new OSSClientBuilder().build(tokenData.ossInternalEndPoint, tokenData.getAccessKeyId(), tokenData.getAccessKeySecret(), tokenData.getSecurityToken());
             } else {
                 ossClient = new OSSClientBuilder().build(tokenData.ossInternetEndPoint, tokenData.getAccessKeyId(), tokenData.getAccessKeySecret(), tokenData.getSecurityToken());
             }
         }
     
         /**
          * Upload file
          *
          * @param filePath
          * @param tokenData
          * @return
          * @throws Exception
          */
         public static String uploadFile(String filePath, DescribeUploadTokenResponseBody.DescribeUploadTokenResponseBodyData tokenData) throws Exception {
             String[] split = filePath.split("\\.");
             String objectName;
             if (split.length > 1) {
                 objectName = tokenData.getFileNamePrefix() + UUID.randomUUID() + "." + split[split.length - 1];
             } else {
                 objectName = tokenData.getFileNamePrefix() + UUID.randomUUID();
             }
             PutObjectRequest putObjectRequest = new PutObjectRequest(tokenData.getBucketName(), objectName, new File(filePath));
             ossClient.putObject(putObjectRequest);
             return objectName;
         }
     
         public static FileModerationResponse invokeFunction(String accessKeyId, String accessKeySecret, String endpoint) throws Exception {
             // Note that the instantiated client here should be reused as much as possible to avoid repeated connections and improve detection performance.
             Client client = createClient(accessKeyId, accessKeySecret, endpoint);
             RuntimeOptions runtime = new RuntimeOptions();
     
             // The full path of the local file, such as D:\localPath\exampleFile.mp3.
             String filePath = "D:/test/1.pdf";
             // Obtain the file upload token
             if (tokenMap.get(endpoint) == null || tokenMap.get(endpoint).expiration <= System.currentTimeMillis() / 1000) {
                 DescribeUploadTokenResponse tokenResponse = client.describeUploadToken();
                 tokenMap.put(endpoint, tokenResponse.getBody().getData());
             }
             // Client for uploading file requests
             getOssClient(tokenMap.get(endpoint), isVPC);
     
             // Upload file
             String objectName = uploadFile(filePath, tokenMap.get(endpoint));
     
             // Construct detection parameters.
             Map<String, String> serviceParameters = new HashMap<>();
             // File upload information
             serviceParameters.put("ossBucketName", tokenMap.get(endpoint).getBucketName());
             serviceParameters.put("ossObjectName", objectName);
             serviceParameters.put("dataId", UUID.randomUUID().toString());
     
             FileModerationRequest request = new FileModerationRequest();
             // Detection type.
             request.setService("document_detection_global");
             request.setServiceParameters(JSON.toJSONString(serviceParameters));
     
             FileModerationResponse response = null;
             try {
                 response = client.fileModerationWithOptions(request, runtime);
             } catch (Exception e) {
                 e.printStackTrace();
             }
             return response;
         }
     
         public static void main(String[] args) throws Exception {
             /**
              * The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
              * Common methods to obtain environment variables:
              * Method 1:
              *     Obtain the RAM user AccessKey ID: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * Method 2:
              *     Obtain the RAM user AccessKey ID: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("It is recommended to obtain the RAM user AccessKey ID from environment variables");
             config.setAccessKeySecret("It is recommended to obtain the RAM user AccessKey Secret from environment variables");
             // Modify the region and address based on actual conditions.
             FileModerationResponse response = invokeFunction(accessKeyId, accessKeySecret, "green-cip.ap-southeast-1.aliyuncs.com");
     
                 // Print the detection results.
                 if (response != null) {
                     if (response.getStatusCode() == 200) {
                         FileModerationResponseBody body = response.getBody();
                         System.out.println(JSON.toJSONString(body));
                         System.out.println("requestId = " + body.getRequestId());
                         System.out.println("code = " + body.getCode());
                         System.out.println("msg = " + body.getMessage());
                         Integer code = body.getCode();
                         if (200 == code) {
                             FileModerationResponseBody.FileModerationResponseBodyData data = body.getData();
                             System.out.println("taskId = [" + data.getTaskId() + "]");
                         } else {
                             System.out.println("file moderation not success. code:" + code);
                         }
                     } else {
                         System.out.println("response not success. status:" + response.getStatusCode());
                     }
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }
     

   • Obtain a code sample for a document detection task

     import com.alibaba.fastjson.JSON;
     import com.alibaba.fastjson.JSONObject;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.DescribeFileModerationResultRequest;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponse;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponseBody;
     import com.aliyun.teaopenapi.models.Config;
     
     
     public class DescribeFileModerationResultDemo {
     
         public static void main(String[] args) throws Exception {
             Config config = new Config();
             /**
              * The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
              * Common methods to obtain environment variables:
              * Method 1:
              *     Obtain the RAM user AccessKey ID: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * Method 2:
              *     Obtain the RAM user AccessKey ID: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("It is recommended to obtain the RAM user AccessKey ID from environment variables");
             config.setAccessKeySecret("It is recommended to obtain the RAM user AccessKey Secret from environment variables");
             // Modify the region and address based on actual conditions
             config.setRegionId("ap-southeast-1");
             config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
             // Connection timeout in milliseconds (ms).
             config.setReadTimeout(6000);
             // Read timeout in milliseconds (ms).
             config.setConnectTimeout(3000);
           
             Client client = new Client(config);
     
             JSONObject serviceParameters = new JSONObject();
             // taskId returned when the task is submitted
             serviceParameters.put("taskId", "fi_f_O5z5i*********-1xxp0V");
     
     
             DescribeFileModerationResultRequest describeFileModerationResultRequest = new DescribeFileModerationResultRequest();
             
             describeFileModerationResultRequest.setService("document_detection_global");
             describeFileModerationResultRequest.setServiceParameters(serviceParameters.toJSONString());
     
             try {
                 DescribeFileModerationResultResponse response = client.describeFileModerationResult(describeFileModerationResultRequest);
                 if (response.getStatusCode() == 200) {
                     DescribeFileModerationResultResponseBody result = response.getBody();
                     System.out.println("requestId=" + result.getRequestId());
                     System.out.println("code=" + result.getCode());
                     System.out.println("msg=" + result.getMessage());
                     if (200 == result.getCode()) {
                         DescribeFileModerationResultResponseBody.DescribeFileModerationResultResponseBodyData data = result.getData();
                         System.out.println("pageResult = " + JSON.toJSONString(data.getPageResult()));
                         System.out.println("dataId = " + data.getDataId());
                         System.out.println("url = " + data.getUrl());
                     } else {
                         System.out.println("file moderation result not success. code:" + result.getCode());
                     }
                 } else {
                     System.out.println("response not success. status:" + response.getStatusCode());
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }

Detect OSS documents

Scenarios

If the document that you want to moderate is stored in Alibaba Cloud Object Storage Service (OSS), you must create a server role to grant Content Moderation access to OSS. Document Moderation 2.0 retrieves the file from OSS for analysis using this server role. To create a server role, visit the Cloud resource access authorization page.

1. Add the following dependencies to the dependencies section:

   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>green20220302</artifactId>
     <version>2.2.11</version>
   </dependency>

   Install the OSS SDK:

   <dependency>
     <groupId>com.aliyun.oss</groupId>
     <artifactId>aliyun-sdk-oss</artifactId>
     <version>3.16.3</version>
   </dependency>

2. Integrate the Java SDK.

   • Sample code for submitting a document detection task

     import com.alibaba.fastjson.JSON;
     import com.alibaba.fastjson.JSONObject;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.FileModerationRequest; 
     import com.aliyun.green20220302.models.FileModerationResponse; 
     import com.aliyun.green20220302.models.FileModerationResponseBody; 
     import com.aliyun.teaopenapi.models.Config;
     
     public class FileModerationDemo {
         public static void main(String[] args) throws Exception {
             Config config = new Config();
              /**
              * The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
              * Common methods to obtain environment variables:
              * Method 1:
              *     Obtain the RAM user AccessKey ID: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * Method 2:
              *     Obtain the RAM user AccessKey ID: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("It is recommended to obtain the RAM user AccessKey ID from environment variables");
             config.setAccessKeySecret("It is recommended to obtain the RAM user AccessKey Secret from environment variables");
             // Modify the region and address based on actual conditions.
             config.setRegionId("ap-southeast-1");
             config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
             // Connection timeout in milliseconds (ms).
             config.setReadTimeout(6000);
             // Read timeout in milliseconds (ms).
             config.setConnectTimeout(3000);
     
             Client client = new Client(config);
             JSONObject serviceParameters = new JSONObject();
             serviceParameters.put("ossBucketName", "bucket_01");
             serviceParameters.put("ossObjectName", "2022023/04/24/test.pdf");
             serviceParameters.put("ossRegionId", "ap-southeast-1"); 
     
             FileModerationRequest fileModerationRequest = new FileModerationRequest(); 
             // Detection type: document_detection_global general document detection
             fileModerationRequest.setService("document_detection_global");
             fileModerationRequest.setServiceParameters(serviceParameters.toJSONString());
     
             try {
                 FileModerationResponse response = client.fileModeration(fileModerationRequest); 
                 if (response.getStatusCode() == 200) {
                     FileModerationResponseBody result = response.getBody(); 
                     System.out.println(JSON.toJSONString(result));
                     System.out.println("requestId = " + result.getRequestId());
                     System.out.println("code = " + result.getCode());
                     System.out.println("msg = " + result.getMessage());
                     Integer code = result.getCode();
                     if (200 == code) {
                         FileModerationResponseBody.FileModerationResponseBodyData data = result.getData();
                         System.out.println("taskId = [" + data.getTaskId() + "]");
                     } else {
                         System.out.println("file moderation not success. code:" + code);
                     }
                 } else {
                     System.out.println("response not success. status:" + response.getStatusCode());
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }
     

   • Sample code for retrieving document detection task results

     import com.alibaba.fastjson.JSON;
     import com.alibaba.fastjson.JSONObject;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.DescribeFileModerationResultRequest;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponse;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponseBody;
     import com.aliyun.teaopenapi.models.Config;
     
     
     public class DescribeFileModerationResultDemo {
     
         public static void main(String[] args) throws Exception {
             Config config = new Config();
             /**
              * The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
              * Common methods to obtain environment variables:
              * Method 1:
              *     Obtain the RAM user AccessKey ID: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * Method 2:
              *     Obtain the RAM user AccessKey ID: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     Obtain the RAM user AccessKey Secret: System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("It is recommended to obtain the RAM user AccessKey ID from environment variables");
             config.setAccessKeySecret("It is recommended to obtain the RAM user AccessKey Secret from environment variables");
             // Modify the region and address based on actual conditions
             config.setRegionId("ap-southeast-1");
             config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
             // Connection timeout in milliseconds (ms).
             config.setReadTimeout(6000);
             // Read timeout in milliseconds (ms).
             config.setConnectTimeout(3000);
           
             Client client = new Client(config);
     
             JSONObject serviceParameters = new JSONObject();
             // taskId returned when the task is submitted
             serviceParameters.put("taskId", "fi_f_O5z5i*********-1xxp0V");
     
     
             DescribeFileModerationResultRequest describeFileModerationResultRequest = new DescribeFileModerationResultRequest();
             
             describeFileModerationResultRequest.setService("document_detection_global");
             describeFileModerationResultRequest.setServiceParameters(serviceParameters.toJSONString());
     
             try {
                 DescribeFileModerationResultResponse response = client.describeFileModerationResult(describeFileModerationResultRequest);
                 if (response.getStatusCode() == 200) {
                     DescribeFileModerationResultResponseBody result = response.getBody();
                     System.out.println("requestId=" + result.getRequestId());
                     System.out.println("code=" + result.getCode());
                     System.out.println("msg=" + result.getMessage());
                     if (200 == result.getCode()) {
                         DescribeFileModerationResultResponseBody.DescribeFileModerationResultResponseBodyData data = result.getData();
                         System.out.println("pageResult = " + JSON.toJSONString(data.getPageResult()));
                         System.out.println("dataId = " + data.getDataId());
                         System.out.println("url = " + data.getUrl());
                     } else {
                         System.out.println("file moderation result not success. code:" + result.getCode());
                     }
                 } else {
                     System.out.println("response not success. status:" + response.getStatusCode());
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }

Detect publicly accessible documents

Scenarios

If the document that you want to moderate is accessible from the Internet, Document Moderation 2.0 retrieves the file using the document URL and then moderates the file.

1. You can run the following command to install pip.

   pip install alibabacloud_green20220302==2.2.11

2. Integrate the Python SDK.

   • Sample code for submitting a document detection task

     # coding=utf-8
     # python version >= 3.6
     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     import json
     
     config = Config(
         # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
         # We strongly recommend that you do not save the AccessKey ID and the AccessKey secret in your project code. Otherwise, the AccessKey pair may be leaked, and this may compromise the security of all resources within your account.
         # Common methods to obtain environment variables:
         # Obtain RAM user AccessKey ID: os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID']
         # Obtain RAM user AccessKey Secret: os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
         access_key_id='It is recommended to obtain the RAM user AccessKey ID from environment variables',
         access_key_secret='It is recommended to obtain the RAM user AccessKey Secret from environment variables',
         # Connection timeout in milliseconds (ms)
         connect_timeout=10000, 
         # Read timeout in milliseconds (ms) 
         read_timeout=3000,  
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     
     clt = Client(config)
     
     serviceParameters = {
         'url': 'https://detect-obj.oss-cn-hangzhou.aliyuncs.com/sample/xxxx.pdf',
     }
     fileModerationRequest = models.FileModerationRequest(
         # Detection type
         service='document_detection_global',
         service_parameters=json.dumps(serviceParameters)
     )
     
     try:
         response = clt.file_moderation(fileModerationRequest)
         if response.status_code == 200:
             # Call successful
             result = response.body
             print('response success. result:{}'.format(result))
         else:
             print('response not success. status:{} ,result:{}'.format(response.status_code, response))
     except Exception as err:
         print(err)

   • Obtain the results of the document detection task

     # coding=utf-8
     # python version >= 3.6
     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     import json
     
     config = Config(
         # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
         # We strongly recommend that you do not save the AccessKey ID and the AccessKey secret in your project code. Otherwise, the AccessKey pair may be leaked, and this may compromise the security of all resources within your account.
         # Common methods to obtain environment variables:
         # Obtain RAM user AccessKey ID: os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID']
         # Obtain RAM user AccessKey Secret: os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
         access_key_id='It is recommended to obtain the RAM user AccessKey ID from environment variables',
         access_key_secret='It is recommended to obtain the RAM user AccessKey Secret from environment variables',
         # Connection timeout in milliseconds (ms)
         connect_timeout=10000, 
         # Read timeout in milliseconds (ms) 
         read_timeout=3000,  
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     
     clt = Client(config)
     
     # taskId returned when the task is submitted
     serviceParameters = {
         "taskId": 'fi_f_11w5THcb*******a-1xx7hH'
     }
     describeFileModerationResultRequest = models.DescribeFileModerationResultRequest(
         # Detection type
         service='document_detection_global',
         service_parameters=json.dumps(serviceParameters)
     )
     
     try:
         response = clt.describe_file_moderation_result(describeFileModerationResultRequest)
         if response.status_code == 200:
             # Call successful
             # Obtain review results
             result = response.body
             print('response success. result:{}'.format(result))
         else:
             print('response not success. status:{} ,result:{}'.format(response.status_code, response))
     except Exception as err:
         print(err)

Detect local documents

Scenarios

If the document that you want to moderate is stored locally and is not accessible from the Internet, you must upload it to an Object Storage Service (OSS) bucket that is provided by Content Moderation. Document Moderation 2.0 then directly accesses OSS to retrieve and moderate the document content.

1. Run the following command to install pip.

   pip install alibabacloud_green20220302==2.2.11

   Install the OSS SDK:

   pip install oss2

2. Integrate the Python SDK.

   • Sample code for submitting a document detection task

     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     from alibabacloud_tea_util.client import Client as UtilClient
     from alibabacloud_tea_util import models as util_models
     import json
     import uuid
     
     import oss2
     import time
     
     configs = Config(
         # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
         # We strongly recommend that you do not save the AccessKey ID and the AccessKey secret in your project code. Otherwise, the AccessKey pair may be leaked, and this may compromise the security of all resources within your account.
         # Common methods to obtain environment variables:
         # Obtain RAM user AccessKey ID: os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID']
         # Obtain RAM user AccessKey Secret: os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
         access_key_id='It is recommended to obtain the RAM user AccessKey ID from environment variables',
         access_key_secret='It is recommended to obtain the RAM user AccessKey Secret from environment variables',
         # Connection timeout in milliseconds (ms).
         connect_timeout=10000,
         # Read timeout in milliseconds (ms).
         read_timeout=10000,
         # Modify the access region and address according to the actual situation.
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     # Note: The instantiated client here should be reused as much as possible to avoid repeated connections and improve detection performance.
     client = Client(configs)
     
     bucket = None
     upload_token = None
     
     
     def get_oss_client(is_vpc):
         global upload_token
         global bucket
         if (upload_token == None) or int(upload_token.expiration) <= int(time.time()):
             response = client.describe_upload_token()
     
             upload_token = response.body.data
             auth = oss2.StsAuth(upload_token.access_key_id, upload_token.access_key_secret, upload_token.security_token)
     
             end_point = upload_token.oss_internet_end_point
             if (is_vpc):
                 end_point = upload_token.oss_internal_end_point
             bucket = oss2.Bucket(auth, end_point, upload_token.bucket_name)
     
     
     def upload_file(file_name, is_vpc):
         get_oss_client(is_vpc)
         object_name = upload_token.file_name_prefix + str(uuid.uuid4()) + '.' + file_name.split('.')[-1]
         bucket.put_object_from_file(object_name, file_name)
         return object_name
     
     
     def file_moderation_by_local_file(file_path, is_vpc):
         # 1. Upload file
         object_name = upload_file(file_path, is_vpc)
     
         # 2. Detection parameters
         service_parameters = {
             'dataId': str(uuid.uuid4()),
             'ossBucketName': upload_token.bucket_name,
             'ossObjectName': object_name
         }
     
         file_moderation_request = models.FileModerationRequest(
             # Detection type.
             service='document_detection_global',
             service_parameters=json.dumps(service_parameters)
         )
     
         # Create a RuntimeObject instance and set runtime parameters.
         runtime = util_models.RuntimeOptions()
         runtime.read_timeout = 10000
         runtime.connect_timeout = 10000
         try:
             global client
             response = client.file_moderation_with_options(file_moderation_request, runtime)
     
             if response.status_code == 200:
                 # Call successful.
                 # Obtain review results.
                 result = response.body
                 print('response success. result:{}'.format(result))
                 if result.code == 200:
                     result_data = result.data
                     print('result: {}'.format(result_data))
             else:
                 print('response not success. status:{} ,result:{}'.format(response.status_code, response))
         except Exception as err:
             print(err)
     
     
     if __name__ == '__main__':
         # Local file path
         file_path = '/Users/test/MS.pdf'
         # Whether to deploy on VPC
         is_vpc = False  # True
         file_moderation_by_local_file(file_path, is_vpc)
          

   • Retrieve document detection task results

     # coding=utf-8
     # python version >= 3.6
     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     import json
     
     config = Config(
         # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
         # We strongly recommend that you do not save the AccessKey ID and the AccessKey secret in your project code. Otherwise, the AccessKey pair may be leaked, and this may compromise the security of all resources within your account.
         # Common methods to obtain environment variables:
         # Obtain RAM user AccessKey ID: os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID']
         # Obtain RAM user AccessKey Secret: os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
         access_key_id='It is recommended to obtain the RAM user AccessKey ID from environment variables',
         access_key_secret='It is recommended to obtain the RAM user AccessKey Secret from environment variables',
         # Connection timeout in milliseconds (ms)
         connect_timeout=10000, 
         # Read timeout in milliseconds (ms) 
         read_timeout=3000,  
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     
     clt = Client(config)
     
     # taskId returned when the task is submitted
     serviceParameters = {
         "taskId": 'fi_f_11w5THcb*******a-1xx7hH'
     }
     describeFileModerationResultRequest = models.DescribeFileModerationResultRequest(
         # Detection type
         service='document_detection_global',
         service_parameters=json.dumps(serviceParameters)
     )
     
     try:
         response = clt.describe_file_moderation_result(describeFileModerationResultRequest)
         if response.status_code == 200:
             # Call successful
             # Obtain review results
             result = response.body
             print('response success. result:{}'.format(result))
         else:
             print('response not success. status:{} ,result:{}'.format(response.status_code, response))
     except Exception as err:
         print(err)

Detect OSS documents

Scenario

If the document that you want to moderate is stored in Alibaba Cloud Object Storage Service (OSS), you must create a server role to grant Content Moderation access to OSS. Document Moderation 2.0 retrieves the file from OSS for analysis using this server role. To create a server role, visit the Cloud resource access authorization page.

1. Run the following command to install pip.

   pip install alibabacloud_green20220302==2.2.11

2. Integrate the Python SDK.

   • Sample code for submitting a document detection task

     # coding=utf-8
     # python version >= 3.6
     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     import json
     
     config = Config(
         # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
         # We strongly recommend that you do not save the AccessKey ID and the AccessKey secret in your project code. Otherwise, the AccessKey pair may be leaked, and this may compromise the security of all resources within your account.
         # Common methods to obtain environment variables:
         # Obtain RAM user AccessKey ID: os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID']
         # Obtain RAM user AccessKey Secret: os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
         access_key_id='It is recommended to obtain the RAM user AccessKey ID from environment variables',
         access_key_secret='It is recommended to obtain the RAM user AccessKey Secret from environment variables',
         # Connection timeout in milliseconds (ms)
         connect_timeout=10000,
         # Read timeout in milliseconds (ms)
         read_timeout=3000,
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     
     clt = Client(config)
     
     serviceParameters = {
         'ossRegionId': 'cn-hangzhou',
         'ossBucketName': 'detect-obj',
         'ossObjectName': 'sample/xxxx.pdf'
     }
     fileModerationRequest = models.FileModerationRequest(
         # Detection type
         service='document_detection_global',
         service_parameters=json.dumps(serviceParameters)
     )
     
     try:
         response = clt.file_moderation(fileModerationRequest)
         if response.status_code == 200:
             # Call successful
             result = response.body
             print('response success. result:{}'.format(result))
         else:
             print('response not success. status:{} ,result:{}'.format(response.status_code, response))
     except Exception as err:
         print(err)
         

   • Retrieve document detection task results

     # coding=utf-8
     # python version >= 3.6
     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     import json
     
     config = Config(
         # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
         # We strongly recommend that you do not save the AccessKey ID and the AccessKey secret in your project code. Otherwise, the AccessKey pair may be leaked, and this may compromise the security of all resources within your account.
         # Common methods to obtain environment variables:
         # Obtain RAM user AccessKey ID: os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID']
         # Obtain RAM user AccessKey Secret: os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
         access_key_id='It is recommended to obtain the RAM user AccessKey ID from environment variables',
         access_key_secret='It is recommended to obtain the RAM user AccessKey Secret from environment variables',
         # Connection timeout in milliseconds (ms)
         connect_timeout=10000, 
         # Read timeout in milliseconds (ms) 
         read_timeout=3000,  
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     
     clt = Client(config)
     
     # taskId returned when the task is submitted
     serviceParameters = {
         "taskId": 'fi_f_11w5THcb*******a-1xx7hH'
     }
     describeFileModerationResultRequest = models.DescribeFileModerationResultRequest(
         # Detection type
         service='document_detection_global',
         service_parameters=json.dumps(serviceParameters)
     )
     
     try:
         response = clt.describe_file_moderation_result(describeFileModerationResultRequest)
         if response.status_code == 200:
             # Call successful
             # Obtain review results
             result = response.body
             print('response success. result:{}'.format(result))
         else:
             print('response not success. status:{} ,result:{}'.format(response.status_code, response))
     except Exception as err:
         print(err)

Detect publicly accessible documents

Scenario

If the document that you want to moderate is accessible from the Internet, Document Moderation 2.0 retrieves the file using the document URL and then moderates the file.

1. Run the following command to add the dependencies:

   composer require alibabacloud/green-20220302 2.2.10

2. Integrate the PHP SDK.

   • Sample code for submitting a document detection task

     <?php
     require('vendor/autoload.php');
     
     use AlibabaCloud\SDK\Green\V20220302\Models\FileModerationRequest;
     use AlibabaCloud\Tea\Exception\TeaUnableRetryError;
     use Darabonba\OpenApi\Models\Config;
     use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
     use AlibabaCloud\SDK\Green\V20220302\Green;
     
     $config = new Config([
         /**
          * The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
          * We strongly recommend that you do not save the AccessKey ID and AccessKey secret in your project code. Otherwise, the AccessKey pair may be leaked, and this may compromise the security of all resources within your account.
          * Common methods to obtain environment variables:
          * Obtain the RAM user AccessKey ID: getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
          * Obtain the RAM user AccessKey secret: getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
          */
         "accessKeyId" => 'It is recommended to obtain the RAM user AccessKey ID from environment variables',
         "accessKeySecret" => 'It is recommended to obtain the RAM user AccessKey secret from environment variables',
         "endpoint" => "green-cip.ap-southeast-1.aliyuncs.com",
         "regionId" => "ap-southeast-1"
     
     ]);
     // Note: Please reuse the instantiated client as much as possible to avoid repeated connections and improve detection performance.
     $client = new Green($config);
     
     $request = new FileModerationRequest();
     $request->service = "document_detection_global";
     $serviceParameters = array("url" => "https://xxx.oss.aliyuncs.com/xxx.pdf");
     
     $request->serviceParameters = json_encode($serviceParameters);
     
     $runtime = new RuntimeOptions();
     $runtime->readTimeout = 6000;
     $runtime->connectTimeout = 3000;
     
     try {
         $response = $client->fileModerationWithOptions($request, $runtime);
         print_r($response->body);
         if (200 != $response->statusCode) {
             print_r("response not success. code:" . $response->statusCode);
             return;
         }
         $body = $response->body;
         print_r("requestId = " . $body->requestId . "\n");
         print_r("code = " . $body->code . "\n");
         print_r("message = " . $body->message . "\n");
         if (200 != $body->code) {
             print_r("file moderation not success. code:" . $body->code);
         }
         $data = $body->data;
         print_r("taskId = " . $data->taskId);
     } catch (TeaUnableRetryError $e) {
         var_dump($e->getMessage());
         var_dump($e->getErrorInfo());
         var_dump($e->getLastException());
         var_dump($e->getLastRequest());
     }

   • Retrieve the results of a document detection task

     <?php
     require('vendor/autoload.php');
     
     use AlibabaCloud\SDK\Green\V20220302\Models\DescribeFileModerationResultRequest;
     use AlibabaCloud\Tea\Exception\TeaUnableRetryError;
     use Darabonba\OpenApi\Models\Config;
     use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
     use AlibabaCloud\SDK\Green\V20220302\Green;
     
     $config = new Config([
         /**
          * The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M.
          * We strongly recommend that you do not save the AccessKey ID and AccessKey secret in your project code. Otherwise, the AccessKey pair may be leaked, and this may compromise the security of all resources within your account.
          * Common methods to obtain environment variables:
          * Obtain the RAM user AccessKey ID: getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
          * Obtain the RAM user AccessKey secret: getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
          */
         "accessKeyId" => 'It is recommended to obtain the RAM user AccessKey ID from environment variables',
         "accessKeySecret" => 'It is recommended to obtain the RAM user AccessKey secret from environment variables',
         "endpoint" => "green-cip.ap-southeast-1.aliyuncs.com",
         "regionId" => "ap-southeast-1"
     
     ]);
     // Note: Please reuse the instantiated client as much as possible to avoid repeated connections and improve detection performance.
     $client = new Green($config);
     
     $request = new DescribeFileModerationResultRequest();
     $request->service = "document_detection_global";
     $serviceParameters = array("taskId" => "fi_f_O5z5iaIis*****NYj7qa-1x****");
     
     $request->serviceParameters = json_encode($serviceParameters);
     
     $runtime = new RuntimeOptions();
     $runtime->readTimeout = 6000;
     $runtime->connectTimeout = 3000;
     
     try {
         $response = $client->describeFileModerationResultWithOptions($request, $runtime);
         if (200 != $response->statusCode) {
             print_r("response not success. code:" . $response->statusCode);
             return;
         }
         $body = $response->body;
         print_r("requestId = " . $body->requestId . "\n");
         print_r("code = " . $body->code . "\n");
         print_r("message = " . $body->message . "\n");
         if (280 == $body->code) {
             print_r("processing file moderation. code:" . $body->code);
             return;
         }
         if (200 != $body->code) {
             print_r("file moderation result not success. code:" . $body->code);
             return;
         }
         $data = $body->data;
           print_r("data = " . json_encode($data) . "\n");
         print_r("pageResult = " . json_encode($data->pageResult) . "\n");
     } catch (TeaUnableRetryError $e) {
         var_dump($e->getMessage());
         var_dump($e->getErrorInfo());
         var_dump($e->getLastException());
         var_dump($e->getLastRequest());
     }

Detect local documents

Scenario

If the document that you want to moderate is stored locally and is not accessible from the Internet, you must upload it to an Object Storage Service (OSS) bucket that is provided by Content Moderation. Document Moderation 2.0 then directly accesses OSS to retrieve and moderate the document content.

1. Run the following command to add the dependencies:

   composer require alibabacloud/green-20220302 2.2.10

   Install the OSS SDK:

   composer require aliyuncs/oss-sdk-php

2. Integrate the PHP SDK.

   • Sample code for submitting a document detection task

   • Retrieve the results of a document detection task

Detect OSS documents

Scenarios

If the document that you want to moderate is stored in Alibaba Cloud Object Storage Service (OSS), you must create a server role to grant Content Moderation access to OSS. Document Moderation 2.0 retrieves the file from OSS for analysis using this server role. To create a server role, visit the Cloud resource access authorization page.

1. Run the following command to add the dependencies:

   composer require alibabacloud/green-20220302 2.2.10

2. Integrate the PHP SDK.

   • Sample code for submitting a document detection task

   • Retrieve the results of a document detection task

Detect publicly accessible documents

Scenario

If the document that you want to moderate is accessible from the Internet, Document Moderation 2.0 retrieves the file using the document URL and then moderates the file.

Detect local documents

Scenarios

If the document that you want to moderate is stored locally and is not accessible from the Internet, you must upload it to an Object Storage Service (OSS) bucket that is provided by Content Moderation. Document Moderation 2.0 then directly accesses OSS to retrieve and moderate the document content.

1. Run the following command to add the dependencies:

   go git clone --branch v2.2.11 github.com/alibabacloud-go/green-20220302/v2

   Install the OSS SDK:

   go get github.com/aliyun/aliyun-oss-go-sdk/oss

2. Integrate the Go SDK.

   • Sample code for submitting a document detection task

   • Retrieve the results of a document detection task

Detect OSS documents

Scenario

If the document that you want to moderate is stored in Alibaba Cloud Object Storage Service (OSS), you must create a server role to grant Content Moderation access to OSS. Document Moderation 2.0 retrieves the file from OSS for analysis using this server role. To create a server role, visit the Cloud resource access authorization page.

1. Run the following command to add the dependencies:

   go git clone --branch v2.2.11 github.com/alibabacloud-go/green-20220302/v2

2. Integrate the Go SDK.

   • Sample code for submitting a document detection task

   • Retrieve document detection task results

Detect publicly accessible documents

Scenarios

If the document that you want to moderate is accessible from the Internet, Document Moderation 2.0 retrieves the file using the document URL and then moderates the file.

1. Run the following command to add the dependencies:

   npm install @alicloud/green20220302@2.2.10

2. Integrate the Node.js SDK.

   • Sample code for submitting a document detection task

     Sample code for retrieving document detection task results

Detect local documents

Scenario

If the document that you want to moderate is stored locally and is not accessible from the Internet, you must upload it to an Object Storage Service (OSS) bucket that is provided by Content Moderation. Document Moderation 2.0 then directly accesses OSS to retrieve and moderate the document content.

1. Run the following command to add the dependencies:

   npm install @alicloud/green20220302@2.2.10

   Install the OSS SDK:

   npm install ali-oss --save

2. Integrate the Node.js SDK.

   • Sample code for submitting a document detection task

     Sample code for retrieving document detection task results

Detect OSS documents

Scenarios

If the document that you want to moderate is stored in Alibaba Cloud Object Storage Service (OSS), you must create a server role to grant Content Moderation access to OSS. Document Moderation 2.0 retrieves the file from OSS for analysis using this server role. To create a server role, visit the Cloud resource access authorization page.

1. Run the following command to add the dependencies:

   npm install @alicloud/green20220302@2.2.10

2. Integrate the Node.js SDK.

   • Sample code for submitting a document detection task

     Sample code for retrieving document detection task results

Detect publicly accessible documents

Scenarios

If the document that you want to moderate is accessible from the Internet, Document Moderation 2.0 retrieves the file using the document URL and then moderates the file.

1. Run the following command to add the dependencies:

   dotnet add package AlibabaCloud.SDK.Green20220302 --version 2.2.10

2. Integrate the C# SDK.

   • Sample code for submitting a document detection task

   • Sample code for retrieving document detection task results

Detect local documents

Scenario

If the document that you want to moderate is stored locally and is not accessible from the Internet, you must upload it to an Object Storage Service (OSS) bucket that is provided by Content Moderation. Document Moderation 2.0 then directly accesses OSS to retrieve and moderate the document content.

1. Run the following command to add the dependencies:

   dotnet add package AlibabaCloud.SDK.Green20220302 --version 2.2.10

   Install the OSS SDK:

   Install via NuGet 
   1. If your Visual Studio does not have NuGet installed, install NuGet first.
   2. In Visual Studio, create a new project or open an existing one, and select Tools > NuGet Package Manager > Manage NuGet Packages for Solution.
   3. Search for aliyun.oss.sdk, find Aliyun.OSS.SDK (for .NET Framework) or Aliyun.OSS.SDK.NetCore (for .Net Core) in the results, select the latest version, and click Install.

2. Integrate the C# SDK.

   • Sample code for submitting a document detection task

   • Sample code for retrieving document detection task results

Detect OSS documents

Scenarios

If the document that you want to moderate is stored in Alibaba Cloud Object Storage Service (OSS), you must create a server role to grant Content Moderation access to OSS. Document Moderation 2.0 retrieves the file from OSS for analysis using this server role. To create a server role, visit the Cloud resource access authorization page.

1. Run the following command to add the dependencies:

   dotnet add package AlibabaCloud.SDK.Green20220302 --version 2.2.10

2. Integrate the C# SDK.

   • Sample code for submitting a document detection task

   • Sample code for retrieving document detection task results