eBay Ecommerce Reader

Note

This adapter is in preview and is available on Striim Developer only. See Striim Developer for more information.

eBay is a global online marketplace that connects vendors with buyers of products and services. eBay allows users to buy, sell, interact other users, and even provide feedback. Striim's eBay Reader converts these application entities into relational tables and facilitates the real-time, straightforward migration of data from the application to any relational database or data warehouse analytics solution, resulting in improved reporting and profound insights.

Feature summary

Feature		Supported?	Notes
Objects	Standard objects	✓
Objects	Custom objects	✓
Authentication	Basic authentication		Username and password
	OAuth authentication	✓	Manual configuration based
	Custom authentication methods		Not all methods may be supported
Operations	Automated mode	✓
	Initial load	✓
	Pull-based incremental load	✓
	Push-based incremental load
	Automated pipeline
Governance	Connection profile
	Sherlock AI
	Sentinel AI
Schema handling	Initial schema creation	✓	Works with supported targets
Schema handling	Schema evolution
Setup	Wizard template
	Flow Designer	✓
	Striim TQL	✓
Runtime	Resilience/recovery	✓
	Parallel execution
	Metrics	✓	Standard metrics

Supported authentication method

The eBay Ecommerce Reader supports OAuth authentication. Creating a connection requires creating an application in the eBay Developer Program Dashboard, obtaining the OAuth credentials from eBay, requesting and obtaining an authorization code, exchanging the authorization code for an access token and refresh token, and setting the connection properties in Striim.

To create a connection using OAuth authentication:

Go to the eBay Developer Program Dashboard.
Choose Application Keys under the API Keys section.
Select Create a new application.
Enter the details for your application.
Note the Client ID (also called App ID) and Client Secret (App Secret) issued to you.
In the eBay Developer Dashboard, specify the redirect URI (where eBay will send users after they authorize access).

Redirect your user to eBay's OAuth URL for authentication. The user will authorize the application to access their account, and eBay will redirect to your specified redirect URI with an authorization code. The URL is in the following format:

https://auth.ebay.com/oauth2/authorize?client_id=<Your-Client-ID>&response_type=code
&redirect_uri=<Your-Redirect-URI>&scope=https://api.ebay.com/oauth/api_scope 
https://api.ebay.com/oauth/api_scope/sell.marketing.readonly 
https://api.ebay.com/oauth/api_scope/sell.marketing 
https://api.ebay.com/oauth/api_scope/sell.inventory.readonly 
https://api.ebay.com/oauth/api_scope/sell.inventory 
https://api.ebay.com/oauth/api_scope/sell.account.readonly 
https://api.ebay.com/oauth/api_scope/sell.account 
https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly 
https://api.ebay.com/oauth/api_scope/sell.fulfillment 
https://api.ebay.com/oauth/api_scope/sell.analytics.readonly

Once the user authorizes the app, they’ll be redirected to your specified redirect URI with an authorization code.

Exchange the authorization code for an access token and refresh token by making a POST request to eBay's token endpoint. The token endpoint URL is:
```
https://api.ebay.com/identity/v1/oauth2/token
```
In the request body, you need to send the following:
- client_id: Your client ID.
- client_secret: Your client secret.
- redirect_uri: The same redirect URI you used before.
- code: The authorization code you received.
- grant_type: authorization_code
  Example (using curl):
```
curl -X POST https://api.ebay.com/identity/v1/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-u "Client-ID:Client-Secret" \
-d "grant_type=authorization_code&code=AUTHORIZATION_CODE
&redirect_uri=YOUR_REDIRECT_URI"
```
  The response will include:
  - access_token: The access token (valid for a limited time).
  - refresh_token: The refresh token (can be used to get new access tokens when expired).
  - expires_in: Time in seconds before the access token expires.

Supported objects

The following are the supported objects for reading from eBay:

Bidders
Categories
CategoryFeatures
CategorySubtree
CategorySuggestions
CategoryTree
CompatibilityProperties
CompatibilityPropertyValues
Countries
Currencies
DefaultCategoryTreeId
FulfillmentPolicies
HighestBidder
ItemAspectsForCategory
ItemCompatibilityList
ItemListing
ItemShipping
ItemSpecifics
ItemTransactions
ItemVariations
MostWatchedItems
OrderPayments
OrderShipping
Orders
PaymentPolicies
ReturnPolicies
ShippingCarriers
ShippingCategories
ShippingLocations
ShippingServices
Sites
SuggestedCategories
Tasks
TopSellingProducts
TransactionLinkedItems
TransactionPayments
TransactionRefunds
TransactionShipping
Transactions