Create a workflow

POST

/amc/reporting/{{instanceId}}/workflows

最后修改时间：2025-03-16 02:19:30

责任人：未设置

Creates a new workflow. The request body is used as the definition for the new workflow. Workflows are defined as a set of operations that take previously defined data sources as input and use them to generate reports.

请求参数

Header 参数

Amazon-Advertising-API-ClientId

string

必需

(Required) The identifier of a client associated with an Amazon Developer account.

示例值:

Amazon-Advertising-API-MarketplaceId

string

必需

(Required) The marketplace identifier for the marketplace in the request. Marketplaces are tied to the country.

示例值:

Amazon-Advertising-API-AdvertiserId

string

必需

(Required) The AMC account identifier. Your Amazon Ads account executive would have provided you this identifier when you onboarded AMC. Alternatively, access the AMC console with your user identifier and password, and grab the entity identifier value that is displayed in the URL. The alphanumeric code that is prefixed with ENTITY is your account identifier. An example of an entity identifier is: ENTITY1AA1AA11AAA1.

示例值:

Authorization

string

必需

示例值:

Bearer {{access_token}}

Body 参数application/json

object {0}

示例

{
    "workflowId": "my-first-workflow0001",
    "sqlQuery": "SELECT advertiser, campaign, sum(total_cost) as spend, sum(impressions) as impressions, count(DISTINCT user_id) as reach FROM dsp_impressions GROUP BY advertiser, campaign"
},
    "timeWindowTimeZone": "UTC",
    "timeWindowType": "MOST_RECENT_WEEK"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://www.amazon.com/ap/oa/amc/reporting/{{instanceId}}/workflows' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Amazon-Advertising-API-MarketplaceId: {{marketplace_id}}' \
--header 'Amazon-Advertising-API-AdvertiserId: {{advertiser_id}}' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "workflowId": "my-first-workflow0001",
    "sqlQuery": "SELECT advertiser, campaign, sum(total_cost) as spend, sum(impressions) as impressions, count(DISTINCT user_id) as reach FROM dsp_impressions GROUP BY advertiser, campaign"
},
    "timeWindowTimeZone": "UTC",
    "timeWindowType": "MOST_RECENT_WEEK"
}'

返回响应

🟢200Create a workflow

text/plain

Body

object {0}

示例

{}

修改于 2025-03-16 02:19:30

Delete AMC instance

Create a workflow with custom parameters