Method: projects.locations.setUpDataConnectorV2

יוצרת Collection ומגדירה את DataConnector בשבילו. כדי להפסיק להשתמש ב-DataConnector אחרי ההגדרה, משתמשים בשיטה CollectionService.DeleteCollection.

בקשת HTTP


POST https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*}:setUpDataConnectorV2

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

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

פרמטרים
parent

string

חובה. ההורה של Collection, בפורמט projects/{project}/locations/{location}.

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

פרמטרים
collectionId

string

חובה. המזהה לשימוש ב-Collection, שיהפוך לרכיב הסופי של שם המשאב של Collection. נוצר Collection חדש כחלק מההגדרה של DataConnector. ‫DataConnector הוא משאב יחיד (singleton) ב-Collection, שמנהל את כל DataStore של Collection.

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

collectionDisplayName

string

חובה. השם המוצג של Collection.

השם צריך להיות קריא לאנשים, והוא משמש להצגת הקולקציות בלוח הבקרה של המסוף. מחרוזת בקידוד UTF-8 עם מגבלה של 1,024 תווים.

גוף הבקשה

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

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של 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.locations.setUpDataConnector

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