文档审核

简介

内容审核功能是由 数据万象（Cloud Infinite，CI）提供的，数据万象将处理能力与 COS SDK 完全结合，您可以直接按照本篇文档指引进行使用。

说明：

使用内容审核服务需拥有数据万象使用权限：

• 主账号请 单击此处 进行角色授权。
• 子账号请参见 授权子账号接入数据万象服务 文档。

本文档提供关于文档审核接口的 API 概览以及 SDK 示例代码。

SDK API 参考

SDK 所有接口的具体参数与方法说明，请参考 SDK API 参考。

提交文档审核任务

功能说明

用于提交文档审核任务。

注意：

COS Android SDK 版本需要大于等于 v5.8.7。

示例代码

        // 存储桶名称，格式为 BucketName-APPID
        String bucket = "examplebucket-1250000000";
        // 对象键，是对象在 COS 上的完整路径，如果带目录的话，格式为 "dir1/object1"
        String cosPath = "dir1/exampleobject.pdf";
        //文档的链接地址,Object 和 Url 只能选择其中一种
        String url = "https://myqcloud.com/%205Document.pdf";
        PostDocumentAuditRequest request = new PostDocumentAuditRequest(bucket);
        request.setObject(cosPath);
        request.setUrl(url);
        //设置原始内容，长度限制为512字节，该字段会在响应中原样返回
        request.setDataId("DataId");
        //回调地址，以http://或者https://开头的地址。
        request.setCallback("https://github.com");
        //审核的场景类型，有效值：Porn（涉黄）、Ads（广告），可以传入多种类型，不同类型以逗号分隔，例如：Porn,Ads。
        request.setDetectType("Porn,Ads");

        // CIService 是 CosXmlService 的子类，初始化方法和 CosXmlService 一致
        ciService.postDocumentAuditAsync(request, new CosXmlResultListener() {
            @Override
            public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
                // result 提交文档审核任务的结果
                // 详细字段请查看api文档或者SDK源码
                PostAuditResult result = (PostAuditResult) cosResult;
            }

            @Override
            public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
                if (clientException != null) {
                    clientException.printStackTrace();
                } else {
                    serviceException.printStackTrace();
                }
            }
        });

说明：

更多完整示例，请前往 GitHub 查看。

查询文档审核任务结果

功能说明

用于查询文档审核任务结果。

注意：

COS Android SDK 版本需要大于等于 v5.8.7。

示例代码

        // 存储桶名称，格式为 BucketName-APPID
        String bucket = "examplebucket-1250000000";
        // 审核任务的 ID
        String jobId = "iab1ca9fc8a3ed11ea834c525400863904";
        GetDocumentAuditRequest request = new GetDocumentAuditRequest(bucket, jobId);
        // CIService 是 CosXmlService 的子类，初始化方法和 CosXmlService 一致
        ciService.getDocumentAuditAsync(request, new CosXmlResultListener() {
            @Override
            public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
                // result 查询文档审核任务的结果
                // 详细字段请查看api文档或者SDK源码
                GetDocumentAuditResult result = (GetDocumentAuditResult) cosResult;
            }

            @Override
            public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
                if (clientException != null) {
                    clientException.printStackTrace();
                } else {
                    serviceException.printStackTrace();
                }
            }
        });

说明：

更多完整示例，请前往 GitHub 查看。