このトピックでは、コンテンツモデレーションモジュールのAPI操作を呼び出す方法の例を示します。 API操作は、ApsaraVideo VOD SDK for Javaにカプセル化されています。 API操作を呼び出して、自動レビュージョブを送信およびクエリできます。 自動レビュー結果を照会し、手動レビュージョブを作成することもできます。
制限事項
自動レビュー機能は、シンガポールリージョンでのみサポートされています。
使用上の注意
この例では、AccessKeyペアを使用してクライアントインスタンスを初期化します。
この操作のリクエストおよびレスポンスパラメーターの詳細については、 OpenAPI Explorerに移動します。 上部のナビゲーションバーで [APIドキュメント] をクリックすると、API操作に関連する情報が表示されます。
このトピックでは、一部の複雑なAPI操作のサンプルコードのみを示します。 他のAPI操作のサンプルコードを取得するには、次の操作を実行します。 Alibaba Cloud OpenAPI Explorerに移動します。左側のナビゲーションウィンドウで、サンプルコードを取得するAPI操作を見つけ、[パラメーター] タブで必要なパラメーターを指定します。 次に、[呼び出しの開始] をクリックします。 [SDKサンプルコード] タブで、サンプルコードを表示およびダウンロードする言語を選択します。
このトピックでは、ApsaraVideo VOD SDK for Java V1.0を使用してAPI操作を呼び出す方法について説明します。 ApsaraVideo VOD SDK for Java V2.0を使用してAPI操作を呼び出す場合、Alibaba Cloud OpenAPI Explorerでサンプルコードを取得するときにV2.0を指定します。
クライアントを初期化
SDKを使用する前に、クライアントを初期化してください。 詳細については、「初期化」をご参照ください。
自動レビュージョブを送信する
SubmitAIMediaAuditJob操作を呼び出して、自動レビュージョブを送信できます。
このAPI操作の詳細については、SubmitAIMediaAuditJobを参照してください。
自動レビュージョブの照会
GetAIMediaAuditJob操作を呼び出して、自動レビュージョブに関する詳細を照会できます。
このAPI操作の詳細については、GetAIMediaAuditJobを参照してください。
自動レビュー結果の照会
GetMediaAuditResult操作を呼び出して、自動レビュージョブの結果を照会できます。
このAPI操作の詳細については、GetAIMediaAuditResultを参照してください。
自動レビュー結果の詳細を照会する
GetMediaAuditResultDetail操作を呼び出して、自動レビュー結果の詳細を照会できます。
このAPI操作の詳細については、GetMediaAuditResultDetailを参照してください。
自動レビュー結果のタイムラインを照会する
GetMediaAuditResultTimeline操作を呼び出して、自動レビュー結果のタイムラインを照会できます。
このAPI操作の詳細については、GetMediaAuditResultTimelineを参照してください。
手動レビュージョブの作成
CreateAuditRequest操作を呼び出して、手動レビュージョブを作成できます。
このAPI操作の詳細については、CreateAuditRequestを参照してください。
サンプルコード:
import com.aliyuncs.auth.AlibabaCloudCredentials;
import com.aliyuncs.auth.EnvironmentVariableCredentialsProvider;
import com.aliyuncs.vod.model.v20170321.CreateAuditRequest;
import com.aliyuncs.vod.model.v20170321.CreateAuditResponse;
import com.alibaba.fastjson.JSONObject;
/**
* Obtain the AccessKey information.
*/
public static DefaultAcsClient initVodClient() throws ClientException {
String regionId = "cn-shanghai"; // Specify the region in which ApsaraVideo VOD is activated.
// 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 recommend that you do not save your AccessKey pair (AccessKey ID and AccessKey secret) in your project code. Otherwise, the AccessKey pair may be leaked. As a result, the security of all resources in your account is compromised.
// In this example, the system reads the AccessKey pair from environment variables to implement authentication for API access. Before you run the sample code, configure the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET.
DefaultProfile profile = DefaultProfile.getProfile(regionId, System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
DefaultAcsClient client = new DefaultAcsClient(profile);
return client;
}
/**
* Specify the content for review.
*/
public static String buildAuditContent() throws Exception {
List<JSONObject> auditContents = new ArrayList<>();
JSONObject auditContent = new JSONObject();
auditContent.put("VideoId", "3ebc10160bda481ca9b6858a0b58****"); // The video ID.
auditContent.put("Status", "Blocked"); // The status of the review job.
auditContent.put("Reason", "Pornography content"); // If the review status is Blocked, a reason must be provided. The reason can contain a maximum of 128 bytes.
auditContents.add(auditContent);
return auditContents.toString();
}
/**
* Create a manual review job.
*/
public static CreateAuditResponse createAudit(DefaultAcsClient client) throws Exception {
CreateAuditRequest request = new CreateAuditRequest();
// The review content.
request.setAuditContent(buildAuditContent());
// The returned results.
return client.getAcsResponse(request);
}
/**
* Sample code
* @param args
*/
public static void main(String[] args) throws Exception {
DefaultAcsClient client = initVodClient();
try {
// Submit manual review results.
CreateAuditResponse response = createAudit(client);
// Display the ID of the request.
System.out.println("ResquestId:" + response.getRequestId());
} catch (Exception e) {
System.out.println("ErrorMessage:" + e.getLocalizedMessage());
}
}
履歴手動レビュージョブの照会
GetAuditHistory操作を呼び出して、履歴手動レビュージョブを照会できます。
このAPI操作の詳細については、GetAuditHistoryを参照してください。
レビューセキュリティグループでのIPアドレスの設定
SetAuditSecurityIp操作を呼び出して、セキュリティグループのIPアドレスを設定できます。
このAPI操作の詳細については、SetAuditSecurityIpを参照してください。
レビューセキュリティグループのIPアドレスの照会
ListAuditSecurityIp操作を呼び出して、セキュリティグループ内のIPアドレスを照会できます。
このAPI操作の詳細については、ListAuditSecurityIpを参照してください。