Method: projects.locations.sampleQuerySets.sampleQueries.create

יצירת SampleQuery

בקשת HTTP

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

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

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

פרמטרים
parent

string

חובה. שם משאב ההורה, למשל projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet}.

פרמטרים של שאילתה

פרמטרים
sampleQueryId

string

חובה. המזהה לשימוש ב-SampleQuery, שיהפוך לרכיב הסופי של SampleQuery.name.

אם למשתמש שקורא לפונקציה אין הרשאה ליצור את SampleQuery, בלי קשר לשאלה אם הוא קיים או לא, הפונקציה מחזירה שגיאה PERMISSION_DENIED.

הערך בשדה הזה חייב להיות ייחודי בין כל הערכים של SampleQuery עם אותו ערך של parent. אחרת, מוחזרת שגיאת ALREADY_EXISTS.

השדה הזה צריך להיות בהתאם לתקן RFC-1034, עם מגבלת אורך של 63 תווים. אחרת, מוחזרת שגיאת INVALID_ARGUMENT.

גוף הבקשה

גוף הבקשה מכיל מופע של SampleQuery.

גוף התשובה

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

היקפי הרשאות

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

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

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

הרשאות IAM

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

  • discoveryengine.sampleQueries.create

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