Method: projects.locations.sampleQuerySets.sampleQueries.import

ייבוא בכמות גדולה של כמה SampleQuery. יכול להיות ששאילתות לדוגמה שכבר קיימות יימחקו.

הערה: יכול להיות שרק חלק מה-SampleQuery יובאו בהצלחה.

בקשת HTTP

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

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

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

פרמטרים
parent

string

חובה. שם המשאב של קבוצת שאילתות האב לדוגמה, כמו projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet}.

אם למבצע הקריאה אין הרשאה להציג רשימה של SampleQuerys במסגרת קבוצת השאילתות לדוגמה הזו, בין אם קבוצת השאילתות לדוגמה הזו קיימת ובין אם לא, מוחזרת שגיאת PERMISSION_DENIED.

גוף הבקשה

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

ייצוג 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.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

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

הרשאות IAM

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

  • discoveryengine.sampleQueries.import

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

InlineSource

המקור המוטבע של SampleQuery.

ייצוג JSON 
{
  "sampleQueries": [
    {
      object (SampleQuery)
    }
  ]
}
שדות
sampleQueries[]

object (SampleQuery)

חובה. רשימה של SampleQuery לייבוא. מקסימום 1,000 פריטים.