Users may wish to create multiple data connectors that pull different entities from the same data source (e.g. YouTube, Vimeo, Twitter). For example, a user might have two YouTube accounts and wish to automatically pull videos from both channels into their Knowledge Graph. Below is a step-by-step guide detailing how to create multiple connectors that pull from the same source!
-
Visit the Connectors page by clicking the Knowledge Graph tab > Connectors
-
On the connector you’d like to duplicate, click the down arrow next to View and select Duplicate. This will create an identical copy of the connector with “Copy” appended to the connector ID and name.
-
Click Edit Configuration.
- Note: Make sure you do not stop here! Creating two connectors that pull the same entities is not recommended, as entities can be mistakenly overwritten if the same sets are pulled into the KG.
-
Navigate to Step 2 of the connector configuration. Here you will alter whichever details differentiate your first connector from this copy. Most often, users will want to change the account from which they pull entities.
-
Each connector is configured slightly differently, but the account ID (or “user ID” or whichever variable you entered when you first installed the app) is likely to be embedded within the Request URL or as a Query Parameter.
- If the account ID “123456” is in the request URL it might look something like https://www.datasource.com/api/v2/123456/entities
- If the account ID is passed as a Query Parameter, the key might be account_id and the value would be 123456.
-
Replace the account ID with the ID of the new account you’d like to pull from.
-
Though unlikely, you may also need to update the API key if your source has a separate API key associated with each account. After you’ve replaced the account ID, you can test whether a new API key is needed by clicking “Pull” in the top right corner. Click “View Raw Response” and if the right entities appear without an error, no new API key is needed! If the call no longer works, retrieve and input the second API key from your data source account.
-
Continue with the connector configuration by editing selectors, transforms, or field mappings (if necessary).
-
On the last step, click Save and then Run your connector!