Content Moderation PHP SDK を使用して、カスタム人物に氏名および備考を追加します。この操作は任意です — 設定した情報は、カスタム取得結果に表示されます。
API の完全なリファレンスについては、「人物情報設定の API オペレーション」をご参照ください。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
必要な PHP バージョンを使用して Content Moderation PHP SDK をインストール済みであること。「インストール」で、バージョン要件とセットアップ手順をご確認ください。
重要
サポート対象外の PHP バージョンを使用すると、その後の API 呼び出しに失敗します。
注意事項
setPerson は、personId で特定されるカスタム人物に備考および氏名を追加します。設定後、氏名および備考はカスタム取得結果に返されます。
この操作は任意です。
この SDK を呼び出す際には、Content Moderation API エンドポイントを使用します。 詳細については、「エンドポイント」をご参照ください。
サンプル
以下のサンプルでは、カスタム人物の氏名および備考を設定するリクエストを送信します。
リクエストパラメーター
| パラメーター | 必須 | 型 | 説明 |
|---|---|---|---|
personId | はい | String | カスタム人物の ID |
name | いいえ | String | カスタム人物の氏名 |
note | いいえ | String | カスタム人物に関する備考 |
コード
<?php
use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;
use AlibabaCloud\Green\Green;
try {
// 環境変数から認証情報を使用してクライアントを初期化します。
// パフォーマンス向上および重複接続の回避のため、このクライアントインスタンスを複数のリクエストで再利用できます。
AlibabaCloud::accessKeyClient(
getenv('ALIBABA_CLOUD_ACCESS_KEY_ID'), // AccessKey ID
getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET') // AccessKey Secret
)
->timeout(10) // クライアントレベルのリクエストタイムアウト:10 秒
->connectTimeout(3) // クライアントレベルの接続タイムアウト:3 秒
->regionId('cn-shanghai')
->asDefaultClient();
// リクエストボディを構築します。
// プレースホルダーの値を実際の personId、氏名、および備考に置き換えてください。
$person = [
'personId' => '<your-person-id>', // 必須
'name' => '<person-name>', // 任意
'note' => '<remarks>', // 任意
];
$result = Green::v20180509()->setPerson()
->timeout(10) // リクエストレベルのタイムアウト:10 秒
->connectTimeout(3) // リクエストレベルの接続タイムアウト:3 秒
->body(json_encode($person))
->request();
print_r($result->toArray());
} catch (ClientException $exception) {
echo $exception->getMessage() . PHP_EOL;
} catch (ServerException $exception) {
echo $exception->getMessage() . PHP_EOL;
echo $exception->getErrorCode() . PHP_EOL;
echo $exception->getRequestId() . PHP_EOL;
echo $exception->getErrorMessage() . PHP_EOL;
}以下のプレースホルダーを置き換えてください。
| プレースホルダー | 説明 | 例 |
|---|---|---|
<your-person-id> | 更新対象のカスタム人物の ID | person_001 |
<person-name> | 人物に割り当てる氏名 | Jane Smith |
<remarks> | 人物にアタッチする備考 | セキュリティ担当者、A 号館 |