Method: projects.locations.userEvents.import

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

התגובה של הפעולה היא מסוג 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)
  },

  // Union field source can be only one of the following:
  "inlineSource": {
    object (InlineSource)
  },
  "gcsSource": {
    object (GcsSource)
  },
  "bigquerySource": {
    object (BigQuerySource)
  }
  // End of list of possible types for union field source.
}
שדות
errorConfig

object (ImportErrorConfig)

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

object (InlineSource)

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

object (GcsSource)

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

object (BigQuerySource)

מקור קלט של BigQuery.

גוף התשובה

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

היקפי הרשאות

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

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

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

הרשאות IAM

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

  • discoveryengine.userEvents.import

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