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)

זה שינוי אופציונלי. אפשרויות שקובעות את תהליך הייבוא של ההערכות.
המקור של ההערכות לייבוא. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
conversationList

object (ImportEvaluationsRequest.ConversationList)

השיחות שמתוכן רוצים לייבא את ההערכות.
gcsUri

string

ה-URI של Google Cloud Storage שממנו רוצים לייבא את ההערכות. הפורמט של ה-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

נדרשות ההרשאות הבאות ב-IAM במשאב parent:

  • 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

הגדרת האסטרטגיה לטיפול בקונפליקטים כשכבר קיים באפליקציה ניתוח עם אותו מזהה ניתוח.

טיפוסים בני מנייה (enum)
CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED לא צוינה אסטרטגיה לפתרון קונפליקטים.
OVERWRITE החלפה של ההערכה הקיימת בהערכה החדשה.
SKIP לשמור את ההערכה הקיימת ולדלג על ההערכה החדשה.
DUPLICATE שומרים את ההערכה הקיימת ומשכפלים את ההערכה החדשה כהערכה חדשה.