Method: projects.locations.apps.importEvaluations

評価をアプリにインポートします。

HTTP リクエスト

POST https://ces.googleapis.com/v1beta/{parent=projects/*/locations/*/apps/*}:importEvaluations

この URL では gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。評価をインポートするアプリ。形式: projects/{project}/locations/{location}/apps/{app}

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "importOptions": {
    object (ImportEvaluationsRequest.ImportOptions)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "conversationList": {
    object (ImportEvaluationsRequest.ConversationList)
  },
  "gcsUri": string,
  "csvContent": string
  // End of mutually exclusive fields.
}
フィールド
importOptions

object (ImportEvaluationsRequest.ImportOptions)

省略可。評価のインポート プロセスを制御するオプション。
インポート元の評価のソース。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
conversationList

object (ImportEvaluationsRequest.ConversationList)

評価のインポート元となる会話。
gcsUri

string

評価のインポート元となる Google Cloud Storage URI。この URI の形式は gs://<bucket-name>/<object-name> にする必要があります。
csvContent

string (bytes format)

評価構造を含む CSV ファイルを表す未加工のバイト。

Base64 でエンコードされた文字列。
相互に排他的なフィールドの終わり。

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

詳細については、Authentication Overview をご覧ください。

IAM 権限

parent リソースに対する次の IAM 権限が必要です。

  • ces.evaluations.create
  • ces.evaluations.update

詳細については、IAM のドキュメントをご覧ください。

ImportEvaluationsRequest.ConversationList

会話リソース名のリスト。

JSON 表現 
{
  "conversations": [
    string
  ]
}
フィールド
conversations[]

string

省略可。会話リソース名。

ImportEvaluationsRequest.ImportOptions

評価のインポート プロセスの構成オプション。これらのオプションは、インポートの動作（特に既存の評価データとの競合が発生した場合の動作）を制御します。

JSON 表現 
{
  "conflictResolutionStrategy": enum (ImportEvaluationsRequest.ImportOptions.ConflictResolutionStrategy)
}
フィールド
conflictResolutionStrategy

enum (ImportEvaluationsRequest.ImportOptions.ConflictResolutionStrategy)

省略可。インポート中に競合を解決するときに使用する戦略。

ImportEvaluationsRequest.ImportOptions.ConflictResolutionStrategy

同じ評価 ID の評価がアプリにすでに存在する場合の競合を処理する戦略を定義します。

列挙型
CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED 競合解決戦略が指定されていません。
OVERWRITE 既存の評価を新しい評価で上書きします。
SKIP 既存の評価を保持し、新しい評価をスキップします。
DUPLICATE 既存の評価を保持し、新しい評価を新しい評価として複製します。