Asset Read
Overview
The Asset Read Snap queries the Asset database to retrieve assets using commands.
You can use this Snap to read data from the following asset types:
- Email Template
- Landing Page
- Landing Page Template
- Snippet
- Form
- Folder
- Program
- Tokens
- This is a Read-type Snap.
Works in Ultra Tasks
Prerequisites
- A valid account with the required permissions. For more info, see Roles and Permissions.
Limitations
- Daily quota: 50,000 API calls per day.
- API rate limit: 100 calls per 20 seconds. If exceeded, the API responds with a 606 error code and the Snap fails.
- Concurrency limit: 10 concurrent API calls.
- Marketo Snaps do not support some special characters (for example, (๐๐๐๐ฌ๐ญ๐ฎ๐๐๐ง๐จ๐ฉ๐๐๐๐๐๐ ๐๐,๐๐๐ฌ๐๐๐๐๐ด)).
Known issues
- If the API rate limit of 100 calls per 20 seconds is exceeded, the API responds with a 606 error code and the Snap fails.
- The Asset Read Snap does not fetch existing data in the Marketo database with special characters and displays the warning: "No assets found for the given search criteria."
- Marketo Snaps do not support some special characters (for example, (๐๐๐๐ฌ๐ญ๐ฎ๐๐๐ง๐จ๐ฉ๐๐๐๐๐๐ ๐๐,๐๐๐ฌ๐๐๐๐๐ด)).
Snap views
| Type | Description | Examples of upstream and downstream Snaps |
|---|---|---|
| Input |
This Snap has at most two document input views. The first input view accepts the command to query the Asset database. The second input view (optional) can be used to pass additional query parameters. |
|
| Output |
This Snap has at most one document output view. A document containing the record on the basis of the input command. |
|
| Learn more about Error handling. | ||
Snap settings
| Field/Field set | Description |
|---|---|
Label*
String |
Specify a unique name for the Snap. Supports expressions.
Default value: Asset Read |
Command*
String/Expression/ Suggestion |
Specify the command to query the Asset database to retrieve assets. Alternatively, click the Suggestion icon to fetch a list of commands and select a command. Note: Some commands require specific data in the input view. In such cases, place the Mapper Snap as an upstream Snap before the Asset Read Snap, validate the pipeline, and note the Target Schema in the Mapper Snap. Refer to the Marketo Assets document for details of each command.
Example: For a complete list of supported commands, refer to the Marketo Asset API documentation. |
| Query Parameters |
Use this fieldset to define the name and value for query parameters that are passed with the asset command. Note:
|
Name
String/Expression |
Specify the name of the query parameter for retrieving assets. Example:
|
Value
String |
Specify the value for the query parameter for retrieving assets. Note:
Example:
|
Timeout (seconds)
Integer/Expression |
Specify the time in seconds to wait for a response from the Marketo server. A value of zero disables the timeout. Default value: 0 |
Number of Retries
Integer/Expression |
Specify the number of attempts the Snap must make in case of connection failure or timeout. Default value: 0 |
Retry Interval (seconds)
Integer/Expression |
Specify the minimum number of seconds the Snap must wait before each retry attempt. Default value: 1 |
Snap execution
Dropdown list |
Choose one of the three modes in
which the Snap executes. Available options are:
Default value: Validate and Execute |