Connector

A resource that represents the configuration of a Connector.

$idstring Required

$schemaconst Required

displayNamestring Required

Display name of this Connector.

entityTypesarray of string

The Entity Types of the entities managed by the Connector.

Each item of this array must be:

Type: string

sourceobject Required

Represents a combination of the configuration to fetch data & selectors to extract content from the raw data.

Required

Configuration for various sources of data.

Type: object

The following properties are required:

  • crawlerConfig
Type: object

The following properties are required:

  • apiPullConfig
Type: object

The following properties are required:

  • apiPushConfig
Type: object

The following properties are required:

  • functionConfig
Type: object

The following properties are required:

  • nativeSourceConfig
Type: object

The following properties are required:

  • fileUploadConfig
Type: object

The following properties are required:

  • ftpConfig

object

Configuration used to extract data from the crawler.

string Required

The reference to the crawler resource.

array of string

List of URL patterns to extract data for.

Each item of this array must be:

Type: string

The URL to extract data for.

array of enum (of string)

Default: [“HTML”]

Specifies which file types to include in your Connector if present in your selected crawler. This setting does not have to match your crawler settings

Must contain a minimum of 1 items

Each item of this array must be:

Type: enum (of string)

Must be one of:

  • “HTML”
  • “PDF”

object

Configuration used to connect and pull data from an API.

enum (of string) Required

The request method type.

Must be one of:

  • “GET”
  • “POST”

string Required

The request URL to use.

object

The request body used to make a POST request.

string Required

The Content-Type used to describe the request body.

string Required

The value of the request body.

The authentication mechanism to use to connect to the API.

Type: object

The following properties are required:

  • bearerToken
Type: object

The following properties are required:

  • basicAuthentication
Type: object

The following properties are required:

  • apiKey
Type: object

The following properties are required:

  • oauth

string

A token that will be passed in the authorization header.

object

Username and password authentication.

string Required

The username.

string

The password.

object

An API key will be used to authenticate requests. The API-key can be appended in the header or as a query param depending on the source API.

string Required

The key used to send the token.

string Required

The API token content.

boolean Required

Indicates if the token should be set as a header instead of a query param.

object

OAuth 2.0 authentication using Linked Accounts.

string Required

A reference to the linked account.

The method used for controlling pagination.

Type: object

The following properties are required:

  • pageBasedPagination
Type: object

The following properties are required:

  • cursorPagination
Type: object

The following properties are required:

  • linkHeaderPagination
Type: object

The following properties are required:

  • offsetPagination

number

Max pages to fetch. If unset, all pages will be fetched.

object

Page-based pagination will increment the page key query parameter value until all pages are returned.

string Required

Pagination key to be passed as a query parameter in the request.

number

Initial value for the page key. If specified, this value will be used as the query parameter value for the Page Key in the first request. If not specified, 0 will be used by default.

object

Points to the total number of pages either in the response body or the response headers.

string Required

The key for the total number of pages. A JMES path expression.

boolean

Default: false

Indicates if the total number pages value is located in the response headers or the response body.

string

Key to specify the max number of entries returned per page, passed as a query parameter in the request.

number

Value for the limit key which specifies the max number of entries returned per page.

object

Cursor-based pagination will look for a cursor in each response and pass it to the subsequent request to fetch the next page.

string

Pagination key to be passed as a query parameter in the request.

string Required

The key that contains the cursor in the response. If detectCursorInHeader is set to true, the key will be searched for in the header. If not set or set to false, the key will be searched for in the response body.

enum (of string) Required

Indicates if the cursor is a Token, Relative URL or Full URL.

Must be one of:

  • “TOKEN”
  • “FULL_URL”
  • “RELATIVE_URL”

boolean

Indicates if the cursor key will be contained in the response header or the response body.

object

Link header pagination will use a link with a specified relation provided in the response header to fetch the next page.

string Required

The label of the link that should be used. In most cases, this will be “next”.

enum (of string)

Default: “FULL_URL”

Indicates if the link is a full URL or a relative URL.

Must be one of:

  • “FULL_URL”
  • “RELATIVE_URL”

object

Offset pagination will use the offset and limit query parameters to paginate through all the items in a collection.

Must not be:

Type: object

The following properties are required:

  • totalPages
  • totalItems

string Required

Offset key to be passed as a query parameter in the request.

string Required

Key to specify the max number of entries returned per page, passed as a query parameter in the request.

number

Default: 0

Value for the offset to be used in the initial request.

number

Value for the limit which specifies the max number of entries returned per page.

object

Points to the total number of pages either in the response body or the response headers.

string Required

The key for the total number of pages. A JMES path expression.

boolean

Default: false

Indicates if the total number of pages value is located in the response headers or the response body.

object

Points to the total number of items either in the response body or the response headers.

string Required

The key for the total number of items. A JMES path expression.

boolean

Default: false

Indicates if the total number of items value is located in the response headers or the response body.

object

The maximum requests that can be made in a specified unit of time.

enum (of string) Required

The unit of time per which the specified quantity of requests can be sent.

Must be one of:

  • “SECOND”
  • “MINUTE”
  • “HOUR”

number Required

The maximum number of requests that may be sent in the specified unit of time.

object

Map of header keys and values to use in the API request.

string Pattern Property

All property whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^.
$

object

Map of query parameter keys and values to use in the API request.

string Pattern Property

All property whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^.
$

object Required

The data format of the response.

Must be one of:

  • “JSON”
  • “EXCEL”
  • “CSV”

object

Configuration used to connect to an app and receive data pushed to the Connectors API endpoint.

object Required

boolean

If enabled, a new run will be initiated every time a request is sent to this Connector and the data provided in the request will be processed.

object

Configuration used to invoke a function.

string Required

The reference to a Plugin resource that contains a desired function.

string Required

The function to invoke.

object Required

object

Configuration used to extract data from a native data source.

string Required

The reference to the native source.

string Required

The method that determines what data to fetch from the native source.

object Required

User-provided inputs required to extract data from the native source.

object

Configuration used to extract data from your uploaded file.

object Required

Specifies configuration on how a file should be processed.

Type: object

The following properties are required:

  • csv
Type: object

The following properties are required:

  • excel

object

Configuration settings to extract data from your CSV file or any delimited file

string

Default: “,”

Specify the delimiter of your file. By default, a comma will be used.

object

Specify if the first row of your data contains the headers for your columns.

Same definition as definitions_fileType_excelConfig_hasHeader

object

Configuration settings to extract data from your Excel file

object

Specify if the first row of your data contains the headers for your columns.

Same definition as source_sourceConfig_fileUploadConfig_config_csv_hasHeader

array of integer

Default: [0]

Specify the indices of the sheets to extract from your excel file. If left empty, the entire workbook will be extracted.

Each item of this array must be:

Type: integer

enum (of string)

Default: “HORIZONTAL”

If multiple worksheets are present, choose to merge sheets horizontally or vertically.

Must be one of:

  • “HORIZONTAL”
  • “VERTICAL”

object

Configuration used to extract data from files fetched from your remote Server.

enum (of string) Required

The protocol to use for establishing connection to your Server.

Must be one of:

  • “SFTP”
  • “FTPS”
  • “FTP”

string Required

The host address without the protocol.

number

The port of your Server (default 21 for FTP, 990 for FTPS or 22 for SFTP).

string Required

The username to authenticate access to the Server.

Required

The credential method to authenticate access to the Server, either via password or an SSH Private Key.

Type: object

The following properties are required:

  • password
Type: object

The following properties are required:

  • sshPrivateKey

string

The password to authenticate access to the Server.

string

The SSH Private Key that will grant access to the Server.

Required

The file location in the Server, including the file extension.

Type: object

The following properties are required:

  • exactFilePath
Type: object

The following properties are required:

  • searchByCriteria

string

The exact path to a specific file in your Server.

object

The criteria used to search through your Server to find a specific file.

enum (of string) Required

The file that matches the criteria that is either the most recently modified or least recently modified.

Must be one of:

  • “NEWEST”
  • “OLDEST”

string Required

The path to the folder containing your file.

enum (of string)

The search pattern rule by which to filter files by name.

Must be one of:

  • “NONE”
  • “CONTAINS”
  • “STARTS_WITH”
  • “ENDS_WITH”
  • “REGEX”

string

The regex by which to filter files.

object Required

Specifies configuration on how a file should be processed.

Type: object

The following properties are required:

  • csv
Type: object

The following properties are required:

  • excel

object

Configuration settings to extract data from your CSV file or any delimited file

Same definition as source_sourceConfig_fileUploadConfig_config_csv

object

Configuration settings to extract data from your Excel file

Same definition as source_sourceConfig_fileUploadConfig_config_excel

object

A selector for extracting content.

enum (of string) Required

The type of data selector.

Must be one of:

  • “CSS”
  • “XPATH”
  • “JSON”
  • “PAGE_URL”
  • “PAGE_TITLE”
  • “CLEANED_BODY”
  • “PAGE_ID”
  • “ITEM_ID”
  • “AUTHOR”
  • “CREATED_DATE”
  • “COLUMN”
  • “FIELD”

string Required

The header used to identify the extracted content.

string

The selector content path.

The specific table column from which to select values.

Type: object

The following properties are required:

  • index
Type: object

The following properties are required:

  • header

number

The zero-base column index.

string

The header based column content.

enum (of string)

The selector mode of a CSS or XPath selector.

Must be one of:

  • “ALL_TEXT”
  • “DIRECT_TEXT”
  • “INNER_HTML”
  • “URL”
  • “IMAGE_URL”
  • “ATTRIBUTE”

string

The attribute key of a CSS or XPath selector.

string

The ID of the field to extract content from.

object

Path to a particular property or list item index.

Each item of this array must be:

Type: object

The following properties are required:

  • name
Type: object

The following properties are required:

  • index

string

A name which identifies a struct value property.

number

An index which identifies an item in a list value.

array

An ordered list of selectors to apply and extract data.

Each item of this array must be:

A selector for extracting content.

Same definition as source_baseSelector

transformsobject

Transforms to sequentially apply to data produced by selectors.

Each item of this array must be:

A transform to apply to the data output by the previous step.

Type: object

The following properties are required:

  • applyTemplateFields
Type: object

The following properties are required:

  • fixCapitalization
Type: object

The following properties are required:

  • removeUnwantedChars
Type: object

The following properties are required:

  • extractText
Type: object

The following properties are required:

  • function
Type: object

The following properties are required:

  • findAndReplace
Type: object

The following properties are required:

  • addColumn
Type: object

The following properties are required:

  • filterRows
Type: object

The following properties are required:

  • formatDates
Type: object

The following properties are required:

  • mergeColumns
Type: object

The following properties are required:

  • splitColumn
Type: object

The following properties are required:

  • fillInEmptyCells
Type: object

The following properties are required:

  • splitIntoRows
Type: object

The following properties are required:

  • formatTimes
Type: object

The following properties are required:

  • ignoreColumns
Type: object

The following properties are required:

  • mapPublisherCategories
Type: object

The following properties are required:

  • aIDataCleaning
Type: object

The following properties are required:

  • duplicateColumn
Type: object

The following properties are required:

  • functionOnARow
Type: object

The following properties are required:

  • checkEntityExistence
Type: object

The following properties are required:

  • convertToRichText

object

Applies the data stored in a template to your data.

string Required

The template in your account to apply.

array Required

The Column headers that should be populated via the fields in the template.

Each item of this array must be:

Type: object

The mapping between a field in your template and a Column Header within the Connector.

string Required

The ID of the field in the template to apply.

object

Path to a particular property or list item index.

Same definition as source_baseSelector_subfieldPath

string Required

The Column Header that should be populated with the template value for the given field.

object

Transforms the text of the input columns by applying the selected capitalization option.

object Required

Specifies which columns should have their values transformed.

array of string

The names of the columns containing values to transform.

Each item of this array must be:

Type: string

The name of the column containing values to transform.

const

True if all columns should be transformed, including any added in the future.

Specific value: true

enum (of string) Required

The clean option to be applied.

Must be one of:

  • “ALL_CAPS”
  • “ALL_LOWER”
  • “PROPER_CASE”

object

Transforms the text of the input columns by applying the selected character removal options.

object Required

Specifies which columns should have their values transformed.

Same definition as transforms_items_fixCapitalization_inputHeaders

array of enum (of string) Required

How the data should be cleaned.

Each item of this array must be:

Type: enum (of string)

The unwanted character removal options to be applied.

Must be one of:

  • “TRIM_WHITESPACE”
  • “REMOVE_WHITESPACE”
  • “REMOVE_NUMBERS”
  • “REMOVE_NON_NUMERICS”
  • “REMOVE_PUNCTUATION”

object

Transforms the text of the input column by extracting text and creating a new column.

Type: object

If the conditions in the “If” tab are respected, then the conditions in the “Then” tab should be respected. Otherwise, the conditions in the “Else” tab should be respected.

Type: object

object

Must match regular expression: [_INSTANCE_MATCHING_TEXT]
Type: object

The following properties are required:

  • valueToFind
Type: object

If the conditions in the “If” tab are respected, then the conditions in the “Then” tab should be respected. Otherwise, the conditions in the “Else” tab should be respected.

Type: object

object

Must match regular expression: [OFFSETFROM]
Type: object

The following properties are required:

  • offsetLength
Type: object

If the conditions in the “If” tab are respected, then the conditions in the “Then” tab should be respected. Otherwise, the conditions in the “Else” tab should be respected.

Type: object

object

Must match regular expression: [SOMETEXT*]
Type: object

The following properties are required:

  • maxLengthTextToKeep

string Required

The header of the column from which text should be extracted

string Required

The header for the new column that will be populated with extracted data

enum (of string) Required

The strategy to be used when determining how much of the text to extract.

Must be one of:

  • “ALL_TEXT_AFTER”
  • “ALL_TEXT_BEFORE”
  • “SOME_TEXT_AFTER”
  • “SOME_TEXT_BEFORE”

enum (of string) Required

From where the extraction operation should occur

Must be one of:

  • “FIRST_INSTANCE_MATCHING_TEXT”
  • “LAST_INSTANCE_MATCHING_TEXT”
  • “OFFSET_FROM_BEGINNING”
  • “OFFSET_FROM_END”

object

The pattern or text to be replaced.

object

A literal text value to be matched. If the value is the empty string, only empty cells in the input columns will be matched.

string Required

Text to be matched.

boolean

Default: false

True if matching should be case-insensitive, false otherwise.

string

Regular expression to be matched (in accordance with the java.util.regex engine).

number

How many characters from the starting point that the extraction should begin.

number

The max number of characters that should be extracted. No limit if 0 or unspecified.

object

Invokes a function to transform values.

object Required

Specifies which columns should have their values transformed.

Same definition as transforms_items_fixCapitalization_inputHeaders

string Required

The reference to a Plugin resource that contains a desired function.

string Required

The function to invoke.

object

Finds a specified pattern or text and replaces it with a specified value.

object Required

Specifies which columns should have their values transformed.

Same definition as transforms_items_fixCapitalization_inputHeaders

object Required

string Required

The text that will replace all found matches. If the replacement value is the empty string, the transform will clear all values that match the valueToFind.

object

Adds a new column and populate the column with a static value

string Required

The new column’s header.

string Required

The column value to be added.

object

Filters rows based on specified conditionals.

enum (of string) Required

The action to perform on rows that satisfy the evaluation of rules.

Must be one of:

  • “KEEP”
  • “REMOVE”

enum (of string) Required

The combinator connecting all rules.

Must be one of:

  • “OR”
  • “AND”

array Required

A list of rules to be applied to filter rows.

Must contain a minimum of 1 items

Each item of this array must be:

A single rule to be applied to filter row.

Type: object

If the conditions in the “If” tab are respected, then the conditions in the “Then” tab should be respected. Otherwise, the conditions in the “Else” tab should be respected.

Type: object

const

Specific value: “IS_BLANK”
Type: object

The following properties are required:

  • conditionalInput
Type: object

If the conditions in the “If” tab are respected, then the conditions in the “Then” tab should be respected. Otherwise, the conditions in the “Else” tab should be respected.

Type: object

const

Specific value: “IS_NOT_BLANK”
Type: object

The following properties are required:

  • conditionalInput

string Required

The column header to which to apply the rule.

enum (of string) Required

The conditional to apply. For conditionals that compare values, the value being processed is on the left, and the conditional input is on the right. When data is in the format of numbers or dates in ISO format (YYYY-MM-DD), they will be compared as numbers or dates respectively. Otherwise, they will be compared as strings

Must be one of:

  • “IS_BLANK”
  • “IS_NOT_BLANK”
  • “EQUALS”
  • “DOES_NOT_EQUAL”
  • “CONTAINS”
  • “DOES_NOT_CONTAIN”
  • “GREATER_THAN”
  • “GREATER_THAN_OR_EQUAL_TO”
  • “LESS_THAN”
  • “LESS_THAN_OR_EQUAL_TO”

string

The conditional input value to apply the conditional against.

object

Formats dates of the specified input into yyyy-MM-dd

object Required

Specifies which columns should have their values transformed.

Same definition as transforms_items_fixCapitalization_inputHeaders

string Required

The date format pattern of the input values (in accordance with java.time.format.DateTimeFormatter).

string

The locale of the input values.

object

Merges multiple columns together into a new column separated by a specified delimiter.

array of string Required

The names of the columns to merge together.

Each item of this array must be:

Type: string

The name of the column containing values to merge.

string Required

The new column’s header.

string Required

The delimiter that separates the merged columns’ values.

object

Split a column into one or more columns based on a specified delimiter.

string Required

The column containing the data that needs to be split.

array of string Required

The names of the columns to split into.

Each item of this array must be:

Type: string

The name of the column containing split values.

string Required

The delimiter used to split the column’s value into new ones.

object

Finds empty cells and fills them in with a specified default value.

object Required

Specifies which columns should have their values transformed.

Same definition as transforms_items_fixCapitalization_inputHeaders

string Required

The text that will replace all empty cells.

object

Splits a column into one or more rows based on a specified delimiter.

string Required

The header of the column containing the values to split.

string Required

The character on which the values should be split.

object

Formats times of the specified input into HH:mm:ss

object Required

Specifies which columns should have their values transformed.

Same definition as transforms_items_fixCapitalization_inputHeaders

string Required

The time format pattern of the input values (in accordance with java.time.format.DateTimeFormatter).

string

The locale of the input values.

object

Remove the given column(s) from the data set

array of string Required

Remove the given column(s) from the data set

Each item of this array must be:

Type: string

The column to remove

object

Converts your Publisher Input Category IDs to Yext Categories

object Required

Specifies which columns should have their values transformed.

Same definition as transforms_items_fixCapitalization_inputHeaders

enum (of string) Required

The Publisher of your data source

Must be one of:

  • “GOOGLEMYBUSINESS”
  • “FACEBOOK”
  • “BING”
  • “TRIPADVISORREVIEWS”

object

Clean your data with an AI model generated by providing sample inputs and outputs.

string Required

The header of the column to transform with the AI model.

string

The header for the new column that will be populated with the transformed data. If no header is provided, then the transformed data will overwrite the input column.

string Required

A description of the type of data transformation.

string Required

A label that describes the input data, e.g., Product URL.

string Required

A label that describes your output data, e.g., Product Category.

array of object Required

Sample input and output values to generate a model.

Must contain a minimum of 3 items

Must contain a maximum of 3 items

Each item of this array must be:

Type: object

string Required

The sample input value.

string Required

The sample output value.

object

Duplicate a column to create a new column with the same data.

string Required

The column containing the data that needs to be duplicated.

string Required

The header for the new column that will be populated with duplicated data

object

Invokes a custom Typescript function to transform an entire row of data.

string Required

The reference to a Plugin resource that contains a desired function.

string Required

The function to invoke.

array

The Column headers containing the values to map to the specified input Keys in the function.

Each item of this array must be:

Type: object

The mapping between a key defined in the function and a Column Header within the Connector.

string Required

The Key that your function specifies.

string Required

The Column Header that contains data that maps to the value of the key in your function.

array Required

The Column headers containing the values to map to the specified output Keys in the function.

Each item of this array must be:

The mapping between a key defined in the function and a Column Header within the Connector.

Same definition as transforms_items_functionOnARow_inputMappings_items

boolean

Default: “false”

If true, any columns not specified as part of the output of the function will be dropped from the table.

object

Specifies the logic driving the conditional execution of a transform on a given row.

object Required

Specifies a set of conditions, and the operator to join them on if more than one condition is present.

enum (of string)

Specifies whether to join conditions via AND or OR logic.

Must be one of:

  • “AND”
  • “OR”

array of object Required

Specifies the conditions that must be met in order for the transform to be executed on a given row.

Must contain a minimum of 1 items

Each item of this array must be:

Type: object

A condition that must be met in order for the transform to be executed.

string Required

The input column containing the value for the condition to meet.

enum (of string) Required

The comparator used when specifying a condition to be met.

Must be one of:

  • “CONTAINS”
  • “STARTS_WITH”
  • “ENDS_WITH”
  • “EQUALS”
  • “DOES_NOT_EQUAL”
  • “IS_NOT_BLANK”
  • “DOES_NOT_CONTAIN”
  • “IS_BLANK”
  • “MATCHES_REGEX”
  • “GREATER_THAN”
  • “GREATER_THAN_OR_EQUAL_TO”
  • “LESS_THAN”
  • “LESS_THAN_OR_EQUAL_TO”

string

The value to compare the input column to to determine if the condition is met. Column headers may be embedded here.

object

Adds a column that checks whether a row represents an entity that currently exists in your Knowledge Graph, by returning a value of true or false.

string Required

The column that contains the value for Entity ID.

string Required

The header of your new column that will be populated with true/false values, based on whether the entity ID provided exists or does not exist in your Knowledge Graph.

object

Convert your data to the JSON AST format to populate fields of type Rich Text v2.

object Required

Specifies which columns should have their values transformed.

Same definition as transforms_items_fixCapitalization_inputHeaders

enum (of string) Required

The input format of your data, either HTML or Markdown.

Must be one of:

  • “HTML”
  • “MARKDOWN”

mappingsarray

The mapping generated by the transformers.

Each item of this array must be:

Type: object

The mapping generated by the transformers.

string Required

Header of a table.

string Required

The reference to the field resource.

object

Path to a particular property or list item index.

Same definition as source_baseSelector_subfieldPath

boolean

Default: false

If true, blank values that are mapped to a field will clear existing field content.

scheduleConfig

The configuration of the run schedule.

Type: object

The following properties are required:

  • useSourceSchedule
Type: object

The following properties are required:

  • customSchedule

boolean

Indicates that the Connector should run automatically using the data source’s schedule.

object

The custom schedule that the Connector will follow. The Connector can be configured to run hourly, daily, weekly, monthly or a custom frequency. Currently, this is only supported for API Connectors.

string Required

The time zone in ISO-8601 Zone-ID to start a run, i.e. America/New_York.

string Required

The local date in ISO format to start scheduling runs, i.e. 2021-01-30.

string Required

The local time in ISO format to start scheduling runs, i.e. 12:00:00.

enum (of string) Required

The schedule config frequency type.

Must be one of:

  • “HOURLY”
  • “DAILY”
  • “MONTHLY”
  • “WEEKLY”

number

The repeat interval based off the schedule config frequency type. If unset, a repeat interval of 1 will be used (e.g. every day).

object

Indicates the run mode.

Must be one of:

  • “DEFAULT”
  • “COMPREHENSIVE”

object

Indicates whether the run is a dry run.

runBreakersarray

The configuration of the set of conditions that will break your run and prevent changes to the Knowledge Graph.

Each item of this array must be:

Type: object

The configuration for a Run Breaker.

enum (of string) Required

The comparator for your breaker.

Must be one of:

  • “EQUAL_TO”
  • “GREATER_THAN”
  • “GREATER_THAN_OR_EQUAL_TO”
  • “LESS_THAN”
  • “LESS_THAN_OR_EQUAL_TO”

number Required

The numerical bound for your breaker.

Value must be greater or equal to 0

enum (of string) Required

Whether the designated bound represents an absolute or relative (percentage) value.

Must be one of:

  • “RELATIVE”
  • “ABSOLUTE”

object Required

The set of entities to consider when breaking the run. This is either entities in the Run, within a specified Saved Filter, or from the Comprehensive Set.

enum (of string) Required

Must be one of:

  • “CURRENT_RUN”
  • “SAVED_FILTER”
  • “COMPREHENSIVE_SET”

string

The reference to the saved filter resource if entity set type is set to saved filter.

Required

A filter on the number of entities that count toward the Run Breaker. This can be whether an entity is new, existing, present in the source of the run, missing from the Comprehensive Set, OR based on value of a mapped Column Header.

Type: object

The following properties are required:

  • statusFilter
Type: object

The following properties are required:

  • fieldFilter

enum (of string)

Must be one of:

  • “NEW”
  • “EXISTING”
  • “PRESENT_IN_SOURCE”
  • “MISSING”

object

string Required

The reference to the field resource.

object

Path to a particular property or list item index.

Same definition as source_baseSelector_subfieldPath

enum (of string) Required

The comparator for your field value.

Must be one of:

  • “IS_BLANK”
  • “IS_NOT_BLANK”
  • “EQUAL_TO”
  • “DOES_NOT_EQUAL”
  • “CONTAINS”
  • “DOES_NOT_CONTAIN”
  • “GREATER_THAN”
  • “GREATER_THAN_OR_EQUAL_TO”
  • “LESS_THAN”
  • “LESS_THAN_OR_EQUAL_TO”
  • “STARTS_WITH”
  • “ENDS_WITH”

string

The value to compare against your field value.

comprehensiveModeConfig Required

The configuration for running the Connector in Comprehensive Mode.

Type: object

The following properties are required:

  • savedFilter

const

Specific value: “ENTITIES_IN_SAVED_FILTER”
Type: object

const

Specific value: “ENTITIES_CREATED_BY_THIS_CONNECTOR”

Type: object

The following properties are required:

  • missingUpdateConfig

const

Specific value: “UPDATE”
Type: object

const

Specific value: “DELETE”

enum (of string) Required

Default: “ENTITIES_CREATED_BY_THIS_CONNECTOR”

The comprehensive set of entities used to determine entities that are missing.

Must be one of:

  • “ENTITIES_CREATED_BY_THIS_CONNECTOR”
  • “ENTITIES_IN_SAVED_FILTER”

string

The reference to the saved filter resources if missing set type is set to ENTITIESINSAVED_FILTER

enum (of string) Required

Default: “DELETE”

Specifies whether entities missing from the comprehensive set should be deleted or updated when running the Connector in Comprehensive Mode.

Must be one of:

  • “DELETE”
  • “UPDATE”

object

The configuration to update entities missing from the comprehensive set IF the action is ‘UPDATE’.

array

An ordered list of selectors to apply and extract from your set of missing entities

Each item of this array must be:

A selector for extracting content.

Same definition as source_baseSelector

object

Transforms to sequentially apply to data produced by selectors.

Same definition as transforms

array

The mapping of columns to fields in Knowledge Graph

Each item of this array must be:

The mapping generated by the transformers.

Same definition as mappings_items

linkedConnectorConfigsarray

The list of configurations of linked connectors’ completed run triggering this connector to run.

Each item of this array must be:

Type: object

The configuration of a linked connector’s completed run triggering this connector to run.

string Required

The reference to the connector whose completed runs will trigger this connector.

object Required

object

Indicates whether the run is a dry run.

Same definition as scheduleConfig_dryRun