Method: projects.locations.userEvents.import

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

‫Operation.response הוא מסוג ImportResponse. שימו לב: יכול להיות שרק חלק מהפריטים יוכנסו בהצלחה. ‫Operation.metadata הוא מסוג ImportMetadata.

בקשת HTTP


POST https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/userEvents:import

כתובות ה-URL כתובות בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. שם משאב DataStore של ההורה, בפורמט projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "errorConfig": {
    object (ImportErrorConfig)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "inlineSource": {
    object (InlineSource)
  },
  "gcsSource": {
    object (GcsSource)
  },
  "bigquerySource": {
    object (BigQuerySource)
  }
  // End of mutually exclusive fields.
}
שדות
errorConfig

object (ImportErrorConfig)

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

object (InlineSource)

מקור מוטבע של תוכן הקלט לאירועי משתמש.
gcsSource

object (GcsSource)

מיקום ב-Cloud Storage של תוכן הקלט.
bigquerySource

object (BigQuerySource)

מקור קלט של BigQuery.
סוף השדות הבלעדיים.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

ניתן למצוא מידע נוסף כאן: Authentication Overview.

הרשאות IAM

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

  • discoveryengine.userEvents.import

מידע נוסף מופיע במאמרי העזרה בנושא IAM.