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.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

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

הרשאות IAM

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

  • discoveryengine.dataConnectors.startConnectorRun

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