- Auth
- Accounts
- First call
- Reporting
- DSP report
- Sponsored ads V3
- Sponsored ads V2
- Snapshots
- Sponsored Products
- Sponsored Display
- Sponsored Brands
- Test accounts
- Amazon Marketing Stream
- Amazon Marketing Cloud
- Administration
- Accounts
- Instances
- Create an instance
- List all instances
- List information about the requested instance
- Update instance details
- Update AWS account metadata in the requested instance
- List advertisers in instance
- Create advertiser update
- Get advertiser update
- Gets advertiser information about the requested AMC instance
- Delete AMC instance
- Reporting
- AMC Audiences
- Rule-based audiences
- Creates query based audience execution metadata informationPOST
- Get all query based audiences execution metadata.GET
- Get query based audience execution metadata for a given audienceExecutionId.GET
- Update query based audience execution metadata for a given audienceExecutionId.PUT
- Delete query based audience execution metadata for a given audienceExecutionId.DELETE
- Lookalike audiences
- Sponsored Products
- Sponsored Brands
- Campaigns
- Ad groups
- Ads
- Targeting
- Recommendations
- Theme targeting
- Create keywords
- Update keyword
- Get keyword
- Delete keyword
- Create negative keywords
- Update negative keyword
- Get negative keyword
- Delete negative keyword
- Create product targets
- Update a product target
- Get product target
- Delete product target
- Create negative product target
- Update negative product target
- Get negative product target
- Delete negative product target
- Get all categories
- Get category refinements
- Ad creatives
- Get brands
- Get landing page ASINS
- Sponsored Display
- Stores
- Product metadata
- Budget rules
- Budget usage
- Creative asset library
- Locations
- Exports
- Sponsored TV
- Amazon DSP
- Partner opportunities
Get all query based audiences execution metadata.
GET
/amc/audiences/query
最后修改时间：2025-03-16 02:19:30
责任人：未设置
请求参数
Query 参数
maxResults
string
必需
示例值:
100
nextToken
string
必需
Header 参数
Amazon-Advertising-API-ClientId
string
必需
示例值:
{{client_id}}
Amazon-Advertising-API-EntityId
string
必需
GET method on amc/accounts to fetch the AMC Account ID/Entity ID.示例值:
{{advertiser_id}}
Amazon-Marketing-Cloud-Audience-InstanceId
string
必需
示例值:
{{instanceId}}
Accept
string
必需
示例值:
application/vnd.amcquerybasedaudience.v1.2+json
Authorization
string
必需
示例值:
Bearer {{access_token}}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://advertising-api.amazon.com/amc/audiences/query?maxResults=100&nextToken=' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Amazon-Advertising-API-EntityId: {{advertiser_id}}' \
--header 'Amazon-Marketing-Cloud-Audience-InstanceId: {{instanceId}}' \
--header 'Accept: application/vnd.amcquerybasedaudience.v1.2+json' \
--header 'Authorization: Bearer {{access_token}}'返回响应
🟢200Successfully get all execution metadata for a given instanceId.
application/json
Body
executionDataList
array [object {23}]
必需
audienceName
string
必需
advertiserId
string
必需
query
string
必需
instanceId
string
必需
timeWindowStart
string
必需
timeWindowEnd
string
必需
createTime
string
必需
lastRefreshedTime
string
必需
dspCanonicalId
string
必需
inputParameters
array [object {5}]
必需
audienceDescription
string
必需
dspAudienceId
string
必需
refreshRateDays
string
必需
audienceCount
string
必需
timeWindowRelative
string
必需
audienceExecutionId
string
必需
audienceType
string
必需
no3pTrackers
string
必需
lookalikeAudienceExpectedReach
string
必需
advertiserType
string
必需
workflowId
string
必需
parameterValues
object
必需
status
string
必需
nextToken
string
必需
示例
{
"executionDataList": [
{
"audienceName": "<string>",
"advertiserId": "<string>",
"query": "<string>",
"instanceId": "<string>",
"timeWindowStart": "<dateTime>",
"timeWindowEnd": "<dateTime>",
"createTime": "<dateTime>",
"lastRefreshedTime": "<dateTime>",
"dspCanonicalId": "<string>",
"inputParameters": [
{
"dataType": "<string>",
"name": "<string>",
"columnType": "DIMENSION",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "DIMENSION",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "METRIC",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "METRIC",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "DIMENSION",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "DIMENSION",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "DIMENSION",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "METRIC",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "METRIC",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "METRIC",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "DIMENSION",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "DIMENSION",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "METRIC",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "METRIC",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "DIMENSION",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "DIMENSION",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "METRIC",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "DIMENSION",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "METRIC",
"defaultValue": "<string>",
"description": "<string>"
},
{
"dataType": "<string>",
"name": "<string>",
"columnType": "METRIC",
"defaultValue": "<string>",
"description": "<string>"
}
],
"audienceDescription": "<string>",
"dspAudienceId": "<string>",
"refreshRateDays": "21",
"audienceCount": "0",
"timeWindowRelative": "false",
"audienceExecutionId": "<string>",
"audienceType": "<string>",
"no3pTrackers": "true",
"lookalikeAudienceExpectedReach": "<string>",
"advertiserType": "DISPLAY",
"workflowId": "<string>",
"parameterValues": {},
"status": "SUCCEEDED"
},
{
"audienceName": "<string>",
"advertiserId": "<string>",
"query": "<string>",
"instanceId": "<string>",
"timeWindowStart": "<dateTime>",
"timeWindowEnd": "<dateTime>",
"createTime": "<dateTime>",
"lastRefreshedTime"修改于 2025-03-16 02:19:30