Method: projects.locations.collections.dataConnector.startConnectorRun

מתחיל תהליך סנכרון מיידי של DataConnector. משתמשים ב-Third Party Connector צריכים לציין אילו ישויות יסונכרנו. מחברי FHIR צריכים לספק חותמת זמן שמציינת את הנקודה בזמן שממנה צריך לסנכרן את הנתונים.

בקשת HTTP


POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*/collections/*/dataConnector}:startConnectorRun

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

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

פרמטרים
parent

string

חובה. שם המחבר של הטופס projects/{project}/locations/{location}/collections/{collectionId}/dataConnector

גוף הבקשה

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

ייצוג ב-JSON 
{
  "entities": [
    string
  ],
  "healthcareFhirResourceTypes": [
    string
  ],
  "forceRefreshContent": boolean,
  "syncIdentity": boolean,
  "syncSinceTimestamp": string
}
שדות
entities[]

string

מציינים אילו ישויות של מחבר צד שלישי צריך לסנכרן. אם לא מציינים ישויות, כל הישויות יסונכרנו.
healthcareFhirResourceTypes[]

string

סוגי משאבי FHIR לייבוא. סוגי המשאבים צריכים להיות קבוצת משנה של כל סוגי המשאבים הנתמכים ב-FHIR. אם לא מציינים ערך, ברירת המחדל היא כל סוגי משאבי ה-FHIR הנתמכים.
forceRefreshContent

boolean

זה שינוי אופציונלי. האם לרענן בכוח את התוכן הלא מובנה של המסמכים.

אם הערך מוגדר ל-true, החלק של התוכן במסמכים ירענן ללא קשר לסטטוס העדכון של התוכן שאליו יש הפניה.
syncIdentity

boolean

אם הערך הוא true, מפעילים סנכרון זהויות.
syncSinceTimestamp

string (Timestamp format)

חותמת זמן שמציינת את הנקודה בזמן שממנה הנתונים צריכים להסתנכרן עבור מחברי נתונים של נתונים בזמן אמת או נתונים באצווה. השדה הזה משמש רק ב-Healthcare Connectors.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

גוף התשובה

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

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של 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.dataConnectors.startConnectorRun

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