DataConnector

ניהול החיבור למקורות נתונים חיצוניים לכל מאגרי הנתונים שמקובצים תחת Collection. זהו משאב יחיד של Collection. ההפעלה נתמכת רק באמצעות ה-method ‏DataConnectorService.SetUpDataConnector, שיוצרת Collection חדש ומפעילה את DataConnector שלו.

ייצוג JSON 
{
  "name": string,
  "state": enum (State),
  "dataSource": string,
  "removeParamKeys": [
    string
  ],
  "refreshInterval": string,
  "nextSyncTime": {
    object (DateTime)
  },
  "entities": [
    {
      object (SourceEntity)
    }
  ],
  "createTime": string,
  "latestPauseTime": string,
  "lastSyncTime": string,
  "updateTime": string,
  "errors": [
    {
      object (Status)
    }
  ],
  "syncMode": enum (SyncMode),
  "kmsKeyName": string,
  "destinationConfigs": [
    {
      object (DestinationConfig)
    }
  ],
  "actionState": enum (State),
  "actionConfig": {
    object (ActionConfig)
  },
  "endUserConfig": {
    object (EndUserConfig)
  },
  "federatedConfig": {
    object (FederatedConfig)
  },
  "connectorModes": [
    enum (ConnectorMode)
  ],
  "staticIpEnabled": boolean,
  "staticIpAddresses": [
    string
  ],
  "oauthStaticIpAddresses": [
    string
  ],
  "blockingReasons": [
    enum (BlockingReason)
  ],
  "identityRefreshInterval": string,
  "identityScheduleConfig": {
    object (IdentityScheduleConfig)
  },
  "privateConnectivityProjectId": string,
  "bapConfig": {
    object (BAPConfig)
  },
  "connectorType": enum (ConnectorType),
  "realtimeState": enum (State),
  "alertPolicyConfigs": [
    {
      object (AlertPolicyConfig)
    }
  ],
  "realtimeSyncConfig": {
    object (RealtimeSyncConfig)
  },
  "aclEnabled": boolean,
  "createEuaSaas": boolean,
  "autoRunDisabled": boolean,
  "incrementalSyncDisabled": boolean,
  "incrementalRefreshInterval": string,
  "hybridIngestionDisabled": boolean,
  "egressFqdns": [
    string
  ],
  "vpcscEnabled": boolean,
  "dynamicTools": [
    {
      object (DynamicTool)
    }
  ],
  "cliConfig": {
    object (CliConfig)
  },
  "connectorSourceId": string,

  // Union field data_connector_params can be only one of the following:
  "params": {
    object
  },
  "jsonParams": string
  // End of list of possible types for union field data_connector_params.
}
שדות
name

string

מזהה. השם המלא של משאב מחבר הנתונים. פורמט: projects/*/locations/*/collections/*/dataConnector
state

enum (State)

פלט בלבד. המצב של המחבר.
dataSource

string

חובה. המזהה של מקור הנתונים. זו רשימה חלקית של מחברים נתמכים. רשימה מלאה של מחברים זמינה במאמרי העזרה.

המחברים הנתמכים לנתונים מאינטראקציה ישירה (First-Party) כוללים:

  • gcs
  • bigquery
  • gcp_fhir
  • google_mail
  • googleDrive
  • google_calendar
  • google_chat

בין המחברים הנתמכים של צדדים שלישיים: מחברים שזמינים לכלל המשתמשים (GA):

  • onedrive
  • outlook
  • confluence
  • jira
  • servicenow
  • sharepoint

תצוגה מקדימה של מחברים:

  • asana
  • azure_active_directory
  • box
  • canva
  • confluence_server
  • custom_connector
  • docusign
  • dropbox
  • dynamics365
  • github
  • gitlab
  • hubspot
  • jira_server
  • linear
  • native_cloud_identity
  • notion
  • okta
  • pagerduty
  • peoplesoft
  • salesforce
  • shopify
  • slack
  • snowflake
  • teams
  • trello
  • workday
  • zendesk
removeParamKeys[]

string

זה שינוי אופציונלי. מציין את המפתחות שיוסרו מהשדה params. ההגדרה הזו פעילה רק אם הפרמטר params נכלל ב-updateMask ב-UpdateDataConnectorRequest. המחיקה מקבלת עדיפות אם מפתח מופיע גם ב-removeParamKeys וגם בשדה params של הבקשה.
refreshInterval

string (Duration format)

חובה. מרווח הרענון לסנכרון הנתונים. אם משך הזמן מוגדר כ-0, הנתונים יסונכרנו בזמן אמת. התכונה של סטרימינג עדיין לא נתמכת. המינימום הוא 30 דקות והמקסימום הוא 7 ימים. אם מגדירים את אותו ערך גם למרווח הרענון וגם למרווח הרענון המצטבר, הסנכרון המצטבר יושבת.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
nextSyncTime

object (DateTime)

הגדרת הזמן המתוזמן לסנכרון הנתונים הבא. בשדה הזה צריך לציין את השעה, הדקה ואזור הזמן ממסד הנתונים של אזור זמן IANA. האפשרות הזו שימושית כשמרווח הרענון של מחבר הנתונים גדול מיום אחד. אם לא תציינו שעות או דקות, נניח שזמן הסנכרון הוא 0:00. כדי למנוע דו-משמעות, המשתמש צריך לציין אזור זמן.
entities[]

object (SourceEntity)

רשימת הישויות ממקור הנתונים המקושר להטמעה.
createTime

string (Timestamp format)

פלט בלבד. חותמת הזמן שבה נוצר DataConnector.

הפלט שנוצר תמיד יהיה בפורמט 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".
latestPauseTime

string (Timestamp format)

פלט בלבד. חותמת הזמן האחרונה שבה DataConnector הושעה, וזה משפיע על כל הפונקציות, כמו סנכרון נתונים. להשהיית מחבר יש את ההשפעות הבאות:

  • כל הפונקציות, כולל סנכרון הנתונים, מושבתות.
  • כל משימת סנכרון נתונים שמתבצעת תבוטל.
  • לא יתוזמנו הפעלות עתידיות של סנכרון נתונים, וגם לא ניתן יהיה להפעיל אותן.

הפלט שנוצר תמיד יהיה בפורמט 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".
lastSyncTime

string (Timestamp format)

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

הפלט שנוצר תמיד יהיה בפורמט 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".
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של העדכון האחרון של DataConnector.

הפלט שנוצר תמיד יהיה בפורמט 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".
errors[]

object (Status)

פלט בלבד. השגיאות מההפעלה האחרונה של המחבר או מההפעלה הראשונית שלו.
syncMode

enum (SyncMode)

מצב סנכרון הנתונים שנתמך על ידי מחבר הנתונים.
kmsKeyName

string

קלט בלבד. מפתח ה-KMS שישמש להגנה על מאגרי הנתונים שמנוהלים על ידי המחבר הזה.

צריך להגדיר את המדיניות הזו לבקשות שצריכות לעמוד בדרישות של מדיניות ארגונית בנושא הגנה באמצעות CMEK.

אם השדה הזה מוגדר והעיבוד שלו מצליח, מאגרי הנתונים שנוצרו על ידי המחבר הזה יהיו מוגנים על ידי מפתח ה-KMS.
destinationConfigs[]

object (DestinationConfig)

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

enum (State)

פלט בלבד. המצב של מחבר הפעולות. הערך הזה משקף אם מחבר הפעולות נמצא בתהליך אתחול, פעיל או שנתקל בשגיאות.
actionConfig

object (ActionConfig)

זה שינוי אופציונלי. הגדרות של פעולות כדי שהמחבר יתמוך בפעולות.
endUserConfig

object (EndUserConfig)

זה שינוי אופציונלי. כל הפרמטרים ופרטי הכניסה שמשמשים במיוחד לחיבורי EUA.
federatedConfig

object (FederatedConfig)

זה שינוי אופציונלי. כל הפרמטרים ופרטי הכניסה שמשמשים במיוחד לחיבורים היברידיים שתומכים במצב מאוחד. צריך להגדיר את השדה הזה רק אם המחבר הוא מחבר היברידי ורוצים להפעיל את מצב FEDERATED.
connectorModes[]

enum (ConnectorMode)

זה שינוי אופציונלי. המצבים שמופעלים למחבר הזה. מצב ברירת המחדל הוא CONNECTOR_MODE_UNSPECIFIED.
staticIpEnabled

boolean

זה שינוי אופציונלי. האם הלקוח הפעיל כתובות IP סטטיות עבור המחבר הזה.
staticIpAddresses[]

string

פלט בלבד. כתובות ה-IP הסטטיות שמשמשות את המחבר הזה.
oauthStaticIpAddresses[]

string

פלט בלבד. כתובות ה-IP הסטטיות שמשמשות את המחבר הזה לממשקי OAuth API (למשל, אימות משתמשי קצה). הם מוצגים בנפרד מ-staticIpAddresses כדי שהלקוחות יוכלו להחיל הגדרות מפורטות של חומת אש לנקודות קצה של OAuth. השדה הזה מאוכלס רק עבור מחברים שמופעל בהם IP סטטי ושמשמשים לפעולות או לחיפוש מאוחד.
blockingReasons[]

enum (BlockingReason)

פלט בלבד. פעולות משתמש שצריך להשלים לפני שהמחבר יכול להתחיל לסנכרן נתונים.
identityRefreshInterval
(deprecated)

string (Duration format)

מרווח הרענון לסנכרון המידע של רשימת בקרת הגישה למסמכים שנקלטים על ידי המחבר הזה. אם לא מגדירים את המדיניות, רשימת בקרת הגישה תתעדכן במרווח הזמן שמוגדר כברירת מחדל – 30 דקות. אפשר להגדיר את פרק הזמן בין רענוני הזהות ל-30 דקות לפחות ועד 7 ימים לכל היותר.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
identityScheduleConfig

object (IdentityScheduleConfig)

ההגדרה של הפעלות סנכרון נתוני הזהויות. השדה הזה מכיל את מרווח הזמן לרענון, שקובע את תדירות הסינכרון של פרטי רשימת בקרת הגישה (ACL) של המסמכים שנקלטים על ידי המחבר הזה.
privateConnectivityProjectId

string

פלט בלבד. מזהה פרויקט הדייר שמשויך למחברים של קישוריות פרטית. כדי שהמחבר יפעל, צריך להוסיף את הפרויקט הזה לרשימת ההיתרים.
bapConfig

object (BAPConfig)

זה שינוי אופציונלי. ההגדרה ליצירת חיבור BAP.
connectorType

enum (ConnectorType)

פלט בלבד. סוג המחבר. כל מקור יכול להיות ממופה רק לסוג אחד. לדוגמה, ל-Salesforce, ל-Confluence ול-Jira יש סוג מחבר THIRD_PARTY. לא ניתן לשנות את הערך הזה אחרי שהמערכת מגדירה אותו.
realtimeState

enum (State)

פלט בלבד. מצב הסנכרון בזמן אמת
alertPolicyConfigs[]

object (AlertPolicyConfig)

זה שינוי אופציונלי. הגדרת ההתראות ברמת המחבר.
realtimeSyncConfig

object (RealtimeSyncConfig)

זה שינוי אופציונלי. ההגדרה של הסנכרון בזמן אמת.
aclEnabled

boolean

זה שינוי אופציונלי. האם המחבר ייווצר עם הגדרת ACL. בשלב הזה, השדה הזה משפיע רק על מחברים של Cloud Storage ו-BigQuery.
createEuaSaas

boolean

זה שינוי אופציונלי. האם מחבר אימות משתמש הקצה נוצר ב-SaaS.
autoRunDisabled

boolean

זה שינוי אופציונלי. השדה מציין אם המחבר מושבת להפעלה אוטומטית. אפשר להשתמש בה כדי להשהות סנכרון תקופתי וסנכרון בזמן אמת. עדכון: עם ההשקה של incrementalSyncDisabled, ‏ autoRunDisabled משמש להשהיה או להשבתה של סנכרון מלא בלבד
incrementalSyncDisabled

boolean

זה שינוי אופציונלי. מציין אם סנכרונים מצטברים מושהים עבור המחבר הזה. ההגדרה הזו לא תלויה בהגדרה autoRunDisabled. רלוונטי רק למחברים של צד שלישי. אם מגדירים את אותו ערך גם לפרק הזמן בין רענונים וגם לפרק הזמן בין סנכרונים מצטברים, הסנכרון המצטבר מושבת, כלומר מוגדר כ-True.
incrementalRefreshInterval

string (Duration format)

זה שינוי אופציונלי. מרווח הרענון שספציפי לסנכרון נתונים מצטבר. אם לא מגדירים את המדיניות, סנכרונים מצטברים ישתמשו בערך ברירת המחדל מהסביבה, שמוגדר ל-3 שעות. המינימום הוא 30 דקות והמקסימום הוא 7 ימים. רלוונטי רק למחברים של צד שלישי. אם מגדירים את אותו ערך גם למרווח הרענון וגם למרווח הרענון המצטבר, הסנכרון המצטבר יושבת.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
hybridIngestionDisabled

boolean

זה שינוי אופציונלי. אם המחבר הוא מחבר היברידי, ההגדרה קובעת אם ההטמעה מופעלת ואם משאבים מתאימים מוקצים במהלך יצירת המחבר. אם המחבר לא היברידי, המערכת מתעלמת מהשדה הזה.
egressFqdns[]

string

פלט בלבד. רשימת שמות הדומיין המלאים (FQDN) שאליהם מחבר הנתונים יכול לשלוח נתונים. זה כולל גם FQDN שנגזר מכתובת ה-URL של המופע שהלקוח סיפק, וגם FQDNs שמוגדרים כברירת מחדל לכל סוג מחבר.
vpcscEnabled

boolean

פלט בלבד. האם המחבר נוצר עם VPC-SC מופעל.
dynamicTools[]

object (DynamicTool)

פלט בלבד. הכלים הדינמיים שאוחזרו עבור המחבר הזה.
cliConfig

object (CliConfig)

זה שינוי אופציונלי. ההגדרה ליצירת חיבור ל-CLI.
connectorSourceId

string

זה שינוי אופציונלי. אם הערך הזה מוגדר, המערכת משתמשת בו במקום בערך dataSource כדי לאחזר את מקור המחבר המתאים.

שדה איחוד data_connector_params. פרמטרים שנדרשים כדי לגשת למקור בפורמט של צמדי (מפתח, ערך). ערכי מחרוזת בפורמט projects/*/[locations/*/]secrets/*/versions/* ייקראו מ-Secret Manager.

פרמטרים שנדרשים לכל מקורות הנתונים:

  • מקש: instance_uri
  • ערך: מחרוזת. כתובת ה-URI לגישה למקור הנתונים.

פרמטרים נדרשים למקורות שתומכים ב-OAuth, כלומר salesforce:

  • מקש: client_id
  • ערך: מחרוזת. מזהה הלקוח של ספק השירות מצד שלישי, לזיהוי האפליקציה שלכם.
  • מקש: client_secret
  • ערך:מחרוזת. סוד הלקוח שנוצר על ידי שרת ההרשאות של הצד השלישי.
  • מקש: access_token
  • ערך: מחרוזת. טוקן OAuth ל-UCS כדי לגשת למשאב המוגן.
  • מקש: refresh_token
  • ערך: מחרוזת. טוקן רענון של OAuth עבור UCS כדי לקבל טוקן גישה חדש ללא אינטראקציה עם המשתמש.

פרמטרים נדרשים למקורות שתומכים באימות בסיסי של טוקן API, כלומר jira, confluence:

  • מקש: user_account
  • ערך: מחרוזת. שם המשתמש או כתובת האימייל עם המקור.
  • מקש: api_token
  • ערך: מחרוזת. טוקן ה-API שנוצר לחשבון המקור, שמשמש לאימות בכל מקום שבו הייתם משתמשים בסיסמה.

דוגמה:

{
                                "instance_uri": "https://xxx.atlassian.net",
                                "user_account": "xxxx.xxx@xxx.com",
                                "api_token": "test-token"
                              }

פרמטר אופציונלי לציון סוג ההרשאה שבו רוצים להשתמש אם יש תמיכה בכמה סוגי הרשאות:

  • מקש: auth_type
  • ערך: מחרוזת. סוג ההרשאה למקור הנתונים. ערכים נתמכים: BASIC_AUTH, ‏ OAUTH, ‏ OAUTH_ACCESS_TOKEN, ‏ OAUTH_TWO_LEGGED, ‏ OAUTH_JWT_BEARER, ‏ OAUTH_PASSWORD_GRANT, ‏ JWT, ‏ API_TOKEN, ‏ FEDERATED_CREDENTIAL, ‏ NO_AUTH. הערך data_connector_params יכול להיות רק אחד מהבאים:
params

object (Struct format)

פרמטרים נדרשים של מחבר נתונים בפורמט json מובנה.
jsonParams

string

פרמטרים נדרשים של מחבר נתונים בפורמט מחרוזת JSON.

מדינה

המצב של המחבר.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת המחדל.
CREATING המחבר נמצא בתהליך הגדרה.
ACTIVE המחבר הוגדר בהצלחה והוא ממתין להרצת הסנכרון הבאה.
FAILED יש שגיאה במחבר. פרטי השגיאה מופיעים בDataConnector.errors. אם אי אפשר לתקן את השגיאה, אפשר למחוק את DataConnector באמצעות CollectionService.DeleteCollection API.
RUNNING המחבר מסנכרן באופן פעיל רשומות ממקור הנתונים.
WARNING המחבר השלים הפעלה של סנכרון, אבל נתקל בשגיאות לא קריטיות.
INITIALIZATION_FAILED האתחול של המחבר נכשל. הסיבות האפשריות כוללות שגיאות בזמן ריצה או בעיות בצינור האסינכרוני, שמונעות מהבקשה להגיע לשירותים במורד הזרם (חוץ מכמה סוגים של מחברים).
UPDATING המחבר נמצא בתהליך עדכון.

SourceEntity

מייצג ישות במקור הנתונים. לדוגמה, האובייקט Account ב-Salesforce.

ייצוג JSON 
{
  "entityName": string,
  "keyPropertyMappings": {
    string: string,
    ...
  },
  "dataStore": string,
  "startingSchema": {
    object (Schema)
  },
  "healthcareFhirConfig": {
    object (HealthcareFhirConfig)
  },

  // Union field entity_params can be only one of the following:
  "params": {
    object
  },
  "jsonParams": string
  // End of list of possible types for union field entity_params.
}
שדות
entityName

string

שם הישות. ערכים נתמכים לפי מקור נתונים:

  • ‫Salesforce: ‏ Lead, ‏ Opportunity, ‏ Contact, ‏ Account, ‏ Case, ‏ Contract, ‏ Campaign
  • ‫Jira: Issue
  • Confluence: ‏ Content, ‏ Space
keyPropertyMappings

map (key: string, value: string)

מאפיינים לאינדוקס. מפתח: שם השדה. ערך: מאפיין המפתח למיפוי שדה, כמו title ו-description. מאפייני מפתח נתמכים:

  • title: הכותרת של רשומת הנתונים. השם יוצג בתוצאות החיפוש.
  • ‫description: תיאור רשומת הנתונים. השם יוצג בתוצאות החיפוש.
dataStore

string

פלט בלבד. השם המלא של המשאב במאגר הנתונים המשויך לישות המקור. פורמט: projects/*/locations/*/collections/*/dataStores/* כשמחברים את המחבר באמצעות השיטה DataConnectorService.SetUpDataConnector, נוצר באופן אוטומטי DataStore לכל ישות מקור.
startingSchema

object (Schema)

זה שינוי אופציונלי. סכימת ההתחלה שתשמש ליצירת DataStore מה-SourceEntity הזה. אם לא מגדירים את המאפיין, המערכת תשתמש בסכימה אנכית מיוחדת שמוגדרת כברירת מחדל.

השדה הזה משמש רק ב-SetUpDataConnector API, ויתעלמו ממנו אם משתמשים בו בממשקי API אחרים. השדה הזה לא יופיע בכל התשובות של ה-API, כולל GetDataConnector API. כדי לאחזר סכימה של DataStore, צריך להשתמש ב-SchemaService.GetSchema API.

הסכימה שסיפקתם תאומת מול כללים מסוימים לגבי סכימה. מידע נוסף זמין במסמך הזה.
healthcareFhirConfig

object (HealthcareFhirConfig)

זה שינוי אופציונלי. הגדרות ל-HEALTHCARE_FHIR אנכי.

שדה איחוד entity_params. הפרמטרים של הישות כדי להקל על הטמעת הנתונים. לדוגמה, במחברי BigQuery:

  • מקש: document_id_column
  • ערך: מחרוזת. הערך של מזהה העמודה. הערך entity_params יכול להיות רק אחד מהבאים:
params

object (Struct format)

הפרמטרים של הישות כדי להקל על הטמעת הנתונים בפורמט JSON מובנה.
jsonParams

string

הפרמטרים של הישות כדי להקל על הטמעת הנתונים בפורמט מחרוזת JSON.

SyncMode

הגדרה של מצב סנכרון הנתונים שנתמך על ידי מחבר הנתונים.

טיפוסים בני מנייה (enum)
PERIODIC המחבר יסנכרן את הנתונים מעת לעת על סמך הערך של refreshInterval. אפשר להשתמש בו עם autoRunDisabled כדי להשהות את הסנכרון התקופתי או לציין סנכרון חד-פעמי.
STREAMING הנתונים יסונכרנו בזמן אמת.
UNSPECIFIED מחבר שלא קולט נתונים יקבל את הערך הזה

DestinationConfig

הגדרה של נקודות קצה (endpoint) של היעד שמשמשות לחיבור למקורות של צד שלישי.

ייצוג JSON 
{
  "key": string,
  "destinations": [
    {
      object (Destination)
    }
  ],

  // Union field destination_config_params can be only one of the following:
  "params": {
    object
  },
  "jsonParams": string
  // End of list of possible types for union field destination_config_params.
}
שדות
key

string

זה שינוי אופציונלי. מזהה יעד ייחודי שהמחבר תומך בו.
destinations[]

object (Destination)

זה שינוי אופציונלי. היעדים של המפתח המתאים.
שדה איחוד destination_config_params. פרמטרים נוספים להגדרת היעד הזה. הערך destination_config_params יכול להיות רק אחד מהבאים:
params

object (Struct format)

זה שינוי אופציונלי. פרמטרים נוספים להגדרת היעד הזה בפורמט JSON מובנה.
jsonParams

string

פרמטרים נוספים להגדרת היעד הזה בפורמט מחרוזת JSON.

יעד

הגדרת נקודת קצה של יעד

ייצוג JSON 
{
  "port": integer,

  // Union field destination can be only one of the following:
  "host": string
  // End of list of possible types for union field destination.
}
שדות
port

integer

זה שינוי אופציונלי. מספר היציאה של היעד התקבל על ידי היעד.
שדה איחוד destination. יעד נקודת הקצה. הערך destination יכול להיות רק אחד מהבאים:
host

string

מארח שאפשר לנתב באופן ציבורי.

ActionConfig

מידע לתמיכה בפעולות במחבר.

ייצוג JSON 
{
  "isActionConfigured": boolean,
  "serviceName": string,
  "useStaticSecrets": boolean,
  "createBapConnection": boolean,
  "userDefinedScopesMapping": {
    string: {
      object (ScopeList)
    },
    ...
  },

  // Union field action_config_params can be only one of the following:
  "actionParams": {
    object
  },
  "jsonActionParams": string
  // End of list of possible types for union field action_config_params.
}
שדות
isActionConfigured

boolean

פלט בלבד. המחבר מכיל את הפרמטרים הנדרשים ומוגדר לתמיכה בפעולות.
serviceName

string

זה שינוי אופציונלי. שם המשאב של Service Directory (projects/*/locations/*/namespaces/*/services/*) שמייצג נקודת קצה של רשת VPC שמשמשת לחיבור אל instanceUri של מקור הנתונים, שמוגדר ב-DataConnector.params.

נדרש כש-VPC Service Controls מופעל.
useStaticSecrets

boolean

זה שינוי אופציונלי. האם להשתמש בסודות סטטיים עבור המחבר. אם הערך הוא True, המערכת תתעלם מהסודות שצוינו ב-actionParams.
createBapConnection

boolean

זה שינוי אופציונלי. האם ליצור חיבור BAP למחבר.
userDefinedScopesMapping

map (key: string, value: object (ScopeList))

זה שינוי אופציונלי. מיפוי משם הפעולה לרשימת ההיקפים. השדה יאוכלס רק אם יש היקפי הרשאות שצוינו על ידי המשתמש.

שדה איחוד action_config_params. פרמטרים שנדרשים לתמיכה בפעולות בפורמט של צמדי (מפתח, ערך). ערכי מחרוזת בפורמט projects/*/[locations/*/]secrets/*/versions/* ייקראו מ-Secret Manager.

פרמטרים נדרשים למקורות שתומכים ב-OAuth, כלומר gmail, ‏ google_calendar, ‏ jira, ‏ workday, ‏ salesforce, ‏ confluence:

  • מקש: client_id
  • ערך: מחרוזת. מזהה הלקוח של ספק השירות שמשמש לזיהוי האפליקציה שלכם.
  • מקש: client_secret
  • ערך:מחרוזת. סוד הלקוח שנוצר על ידי שרת ההרשאות של האפליקציה. הערך action_config_params יכול להיות רק אחד מהבאים:
actionParams

object (Struct format)

זה שינוי אופציונלי. פרמטרים של פעולה בפורמט JSON מובנה.
jsonActionParams

string

זה שינוי אופציונלי. פרמטרים של פעולה בפורמט מחרוזת JSON.

ScopeList

מאחסן רשימה של היקפי הרשאות.

ייצוג JSON 
{
  "scopes": [
    string
  ]
}
שדות
scopes[]

string

זה שינוי אופציונלי. רשימת ההיקפים.

EndUserConfig

כל הפרמטרים ופרטי הכניסה שמשמשים במיוחד לחיבורי EUA.

ייצוג JSON 
{
  "additionalParams": {
    object
  },
  "tenant": {
    object (Tenant)
  },

  // Union field auth_config can be only one of the following:
  "authParams": {
    object
  },
  "jsonAuthParams": string
  // End of list of possible types for union field auth_config.
}
שדות
additionalParams

object (Struct format)

זה שינוי אופציונלי. כל פרמטר נוסף שנדרש ל-EUA.
tenant

object (Tenant)

זה שינוי אופציונלי. פרויקט הדייר שאליו המחבר מחובר.
שדה איחוד auth_config. הגדרת האימות של מחברי EUA. הערך auth_config יכול להיות רק אחד מהבאים:
authParams

object (Struct format)

זה שינוי אופציונלי. כל פרמטר אימות שספציפי למחברי EUA.
jsonAuthParams

string

זה שינוי אופציונלי. פרמטרים של אימות שספציפיים למחברי EUA בפורמט מחרוזת JSON.

דייר (tenant)

פרטי הדייר של מקור מחבר. המידע הזה כולל חלק מהפרטים שמאוחסנים בהודעת האישורים, אבל הוא מוגבל רק למה שנדרש כדי לספק למשתמש רשימה של דיירים שאפשר לגשת אליהם.

ייצוג JSON 
{
  "id": string,
  "uri": string,
  "displayName": string
}
שדות
id

string

מזהה המכונה של הדייר. דוגמאות: Jira‏ (8594f221-9797-5f78-1fa4-485e198d7cd0), ‏ Slack‏ (T123456).
uri

string

ה-URI של הדייר, אם רלוונטי. לדוגמה, ה-URI של מופע Jira הוא https://my-jira-instance.atlassian.net, ולדייר Slack אין URI.
displayName

string

שם תצוגה אופציונלי לדייר, למשל 'הצוות שלי ב-Slack'.

FederatedConfig

כל הפרמטרים ופרטי הכניסה שמשמשים במיוחד לחיבורים היברידיים שתומכים במצב מאוחד.

ייצוג JSON 
{
  "additionalParams": {
    object
  },

  // Union field auth_config can be only one of the following:
  "authParams": {
    object
  },
  "jsonAuthParams": string
  // End of list of possible types for union field auth_config.
}
שדות
additionalParams

object (Struct format)

זה שינוי אופציונלי. פרמטרים נוספים שנדרשים ל-FEDERATED.
שדה איחוד auth_config. הגדרת האימות למחברים מאוחדים. הערך auth_config יכול להיות רק אחד מהבאים:
authParams

object (Struct format)

זה שינוי אופציונלי. פרמטרים של אימות שספציפיים למחברים מאוחדים.
jsonAuthParams

string

זה שינוי אופציונלי. פרמטרים של אימות שספציפיים למחברים מאוחדים בפורמט מחרוזת JSON.

ConnectorMode

המצבים שמופעלים למחבר הזה. INGESTION, ACTIONS, FEDERATED, OR EUA

טיפוסים בני מנייה (enum)
CONNECTOR_MODE_UNSPECIFIED מצב המחבר לא מוגדר.
DATA_INGESTION המחבר שמשמש להעברת נתונים.
ACTIONS מחבר שמשמש לפעולות.
FEDERATED מחבר שמשמש לחיפוש מאוחד.
EUA מחבר שמשמש לאימות משתמשי קצה.
FEDERATED_AND_EUA מחבר היברידי שמשמש לחיפוש מאוחד ולאימות משתמשי קצה.

BlockingReason

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

טיפוסים בני מנייה (enum)
BLOCKING_REASON_UNSPECIFIED ערך ברירת המחדל.
ALLOWLIST_STATIC_IP כדי להשתמש במחבר, הלקוח צריך להוסיף כתובות IP סטטיות לרשימת ההיתרים.
ALLOWLIST_IN_SERVICE_ATTACHMENT כדי להשתמש ב-Connector, הלקוח צריך להוסיף את הפרויקט שלנו לרשימת ההיתרים בקובץ השירות שלו.
ALLOWLIST_SERVICE_ACCOUNT כדי להשתמש בכלי לחיבור נתונים, הלקוח צריך להוסיף את חשבון השירות לרשימת מורשי הגישה בפרויקט שלו.

IdentityScheduleConfig

ההגדרה של הפעלות סנכרון נתוני הזהויות.

ייצוג JSON 
{
  "refreshInterval": string,
  "nextSyncTime": {
    object (DateTime)
  }
}
שדות
refreshInterval

string (Duration format)

זה שינוי אופציונלי. מרווח הרענון לסנכרון המידע של רשימת בקרת הגישה למסמכים שנקלטים על ידי המחבר הזה. אם לא מגדירים את המדיניות, רשימת בקרת הגישה תתעדכן במרווח הזמן שמוגדר כברירת מחדל – 30 דקות. אפשר להגדיר את פרק הזמן בין רענוני הזהות ל-30 דקות לפחות ועד 7 ימים לכל היותר.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
nextSyncTime

object (DateTime)

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

BAPConfig

ההגדרה של מחבר BAP.

ייצוג JSON 
{
  "supportedConnectorModes": [
    enum (ConnectorMode)
  ],
  "enabledActions": [
    string
  ],
  "toolspecOverride": {
    object (ToolspecOverride)
  }
}
שדות
supportedConnectorModes[]

enum (ConnectorMode)

חובה. מצבי המחבר הנתמכים לחיבור BAP המשויך.
enabledActions[]

string

זה שינוי אופציונלי. הפעולות שמופעלות בחיבור BAP המשויך.
toolspecOverride

object (ToolspecOverride)

זה שינוי אופציונלי. הגדרות שמוגדרות מראש לחיבור הזה. במקרה של מחברים של Enterprise BAP שתומכים בהגדרות כלים שאדמינים בוחרים, המאפיין הזה מכיל את ההגדרות (הפשוטות) של ביטול ברירת המחדל לכל כלי. ב-Get, מאוכלס על ידי השרת על ידי מיזוג של שינויים קבועים עם הגדרות של כלי בזמן ריצה, וקיצוץ התוצאה לשימוש בממשק המשתמש. בפעולת העדכון, הערך שסופק מחליף את הערכים שמוגדרים כברירת מחדל אחרי אימות ומיזוג בצד השרת: השדה baseVersion חייב להתאים לגרסה הנוכחית של מפרט הכלים הבסיסי של השרת (אחרת הבקשה נדחית עם שגיאה שמוצגת למשתמש ומפנה את האדמין להוריד מחדש את הכלים העדכניים).

ConnectorMode

תרחישי שימוש שנתמכים על ידי המחבר הזה של BAP.

טיפוסים בני מנייה (enum)
CONNECTOR_MODE_UNSPECIFIED מצב המחבר לא מוגדר.
DATA_INGESTION המחבר שמשמש להעברת נתונים.
ACTIONS המחבר שמשמש לפעולות
END_USER_AUTHENTICATION מחבר שמשמש לאימות משתמשי קצה.

ToolspecOverride

תצוגה שפונה ללקוח של מפרט הכלי שנבחר על ידי האדמין לחיבור BAP. ההגדרות (הפשוטות) של כל כלי שמוצגות לאדמין בממשק המשתמש של מנוע הגילוי, והאדמין יכול לערוך אותן.

הוא משקף את הצורה של הודעת google.cloud.connectorexecution.v1.ToolspecOverride בקצה העורפי, אבל הוא מוגדר בכוונה כסוג ציבורי נפרד כדי שממשק Discovery Engine API יוכל להתפתח בנפרד מממשק fed-API (AIP-215). ה-Handlers מבצעים המרה בין שני הפורמטים באמצעות פונקציות עזר ב-‎ //cloud/ml/discoveryengine/external_service/v1main/data_connector_service/lib:bap_custom_tool_util‎:

ייצוג JSON 
{
  "tools": [
    {
      object
    }
  ],
  "baseVersion": string
}
שדות
tools[]

object (Struct format)

חובה. הגדרות של כלים (מבנה אחד לכל כלי) שהאדמין התאים אישית בנוסף למפרט הכלים הבסיסי שמוחזר על ידי ה-API המאוחד. חובה, כי זה השדה היחיד שמשתמש יכול לערוך ב-modify API. הבקשה חייבת להכיל לפחות כלי אחד.
baseVersion

string

חובה. גרסת מפרט כלי הבסיס שבה נוצרו tools. במהלך עדכון, הגרסה חייבת להיות זהה לגרסה היציבה הנוכחית של כלי ה-toolspec בשרת לצורך החיבור. אם יש אי התאמה, העדכון נדחה ומוצגת למשתמש שגיאה שמפנה את האדמין להורדה מחדש של הגרסה העדכנית ביותר.

ConnectorType

סוג המחבר. יכול להיות שבעתיד יתווספו ערכים חדשים ל-enum הזה.

טיפוסים בני מנייה (enum)
CONNECTOR_TYPE_UNSPECIFIED ערך ברירת המחדל.
THIRD_PARTY מחבר של צד שלישי למחבר של צד שלישי לאפליקציה של צד שלישי.
GCP_FHIR מחבר הנתונים מתחבר בין מאגר FHIR למאגר הנתונים של VAIS.
BIG_QUERY מחבר BigQuery.
GCS מחבר Google Cloud Storage.
GOOGLE_MAIL מחבר Gmail.
GOOGLE_CALENDAR ‫Google Calendar connector.
GOOGLE_DRIVE מחבר ל-Google Drive.
NATIVE_CLOUD_IDENTITY מחבר מקורי של Cloud Identity לחיפוש אנשים, שמבוסס על People API.
THIRD_PARTY_FEDERATED מחבר מאוחד, שהוא מחבר של צד שלישי שלא מבצע המרת נתונים, והחיפוש מבוסס על API של אפליקציית צד שלישי.
THIRD_PARTY_EUA מחבר שמשמש לתכונות של אימות משתמשי קצה.
GCNV מחבר Google Cloud NetApp Volumes.
GOOGLE_CHAT מחבר Google Chat.
GOOGLE_SITES מחבר Google Sites.
REMOTE_MCP מחבר מבוסס MCP מרוחק.
GOOGLE_WORKSPACE מחבר ל-Google Workspace.

AlertPolicyConfig

הגדרת ההתראות ברמת המחבר.

ייצוג JSON 
{
  "alertPolicyName": string,
  "alertEnrollments": [
    {
      object (AlertEnrollment)
    }
  ]
}
שדות
alertPolicyName

string

אי אפשר לשנות. השם המלא של המשאב AlertPolicy.
alertEnrollments[]

object (AlertEnrollment)

זה שינוי אופציונלי. מצב ההרשמה של כל התראה.

AlertEnrollment

סטטוס ההרשמה להתראה.

ייצוג JSON 
{
  "alertId": string,
  "enrollState": enum (EnrollStates)
}
שדות
alertId

string

אי אפשר לשנות. המזהה של ההתראה.
enrollState

enum (EnrollStates)

חובה. סטטוס ההרשמה של הלקוח.

EnrollStates

סטטוס ההרשמה של ההתראה.

טיפוסים בני מנייה (enum)
ENROLL_STATES_UNSPECIFIED ערך ברירת המחדל. משמש לקוחות שלא הגיבו למדיניות ההתראות.
ENROLLED הלקוח רשום למדיניות הזו.
DECLINED הלקוח דחה את המדיניות הזו.

RealtimeSyncConfig

ההגדרה של סנכרון בזמן אמת לאחסון פרמטרים נוספים של סנכרון בזמן אמת.

ייצוג JSON 
{
  "webhookUri": string,
  "realtimeSyncSecret": string,
  "streamingError": {
    object (StreamingError)
  }
}
שדות
webhookUri

string

זה שינוי אופציונלי. כתובת URL של Webhook למחבר, לציון פרמטרים נוספים לסנכרון בזמן אמת.
realtimeSyncSecret

string

זה שינוי אופציונלי. המזהה של הסוד ב-Secret Manager שמשמש כסוד של ה-webhook.
streamingError

object (StreamingError)

זה שינוי אופציונלי. פרטים על שגיאה בשידור.

StreamingError

פרטים על שגיאה בשידור.

ייצוג JSON 
{
  "streamingErrorReason": enum (StreamingErrorReason),
  "error": {
    object (Status)
  }
}
שדות
streamingErrorReason

enum (StreamingErrorReason)

זה שינוי אופציונלי. שגיאה בשידור.
error

object (Status)

זה שינוי אופציונלי. פרטי השגיאה.

StreamingErrorReason

סוגים כלליים של שגיאות בסטרימינג.

טיפוסים בני מנייה (enum)
STREAMING_ERROR_REASON_UNSPECIFIED לא צוינה סיבה לשגיאה בהזרמת נתונים.
STREAMING_SETUP_ERROR אירעה שגיאה במהלך הגדרת המשאבים לסנכרון בזמן אמת.
STREAMING_SYNC_ERROR אירעה שגיאה במהלך הפעלת סינכרון בזמן אמת למחבר.
INGRESS_ENDPOINT_REQUIRED כשמגדירים סנכרון בזמן אמת בקישוריות פרטית, צריך להגדיר נקודת קצה של תעבורת נכנסת.

DynamicTool

הגדרה של כלים דינמיים.

ייצוג JSON 
{
  "name": string,
  "description": string,
  "enabled": boolean,
  "displayName": string
}
שדות
name

string

חובה. שם הכלי.
description

string

זה שינוי אופציונלי. תיאור הכלי.
enabled

boolean

זה שינוי אופציונלי. האם הכלי מופעל.
displayName

string

זה שינוי אופציונלי. השם המוצג של הכלי.

CliConfig

ההגדרה של המחברים שמבוססים על הפעלת ה-CLI.

ייצוג JSON 
{
  "enabledActions": [
    string
  ]
}
שדות
enabledActions[]

string

זה שינוי אופציונלי. הפעולות שמופעלות בחיבור ה-CLI המשויך.