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
  ],
  "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,

  // 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 הסטטיות שמשמשות את המחבר הזה.
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 שמוגדרים כברירת מחדל לכל סוג של מחבר. הערה: השדה הזה נגזר גם מ-DataConnector.params וגם ממפרט המקור של מחבר. צריך להשתמש בו רק למטרות הערכה של CAIS ומדיניות הארגון.
vpcscEnabled

boolean

פלט בלבד. האם המחבר נוצר עם VPC-SC מופעל. הפרמטר הזה משמש רק למטרות הערכה של CuOP.

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

פרמטרים שחובה להוסיף לכל מקורות הנתונים:

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

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

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

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

  • מקש: user_account
  • ערך: סוג STRING. שם המשתמש או כתובת האימייל עם המקור.
  • מקש: api_token
  • ערך: סוג STRING. טוקן ה-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. הערך 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
  • ערך: סוג STRING. הערך של מזהה העמודה. הערך 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,
  "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.
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, הלקוח צריך להוסיף את הפרויקט שלנו לרשימת ההיתרים ב-Service Attachment שלו.
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
  ]
}
שדות
supportedConnectorModes[]

enum (ConnectorMode)

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

string

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

ConnectorMode

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

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

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 מרוחק.

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 כשמגדירים סנכרון בזמן אמת בקישוריות פרטית, צריך להגדיר נקודת קצה של תעבורת נתונים נכנסת (ingress).