Amazon Ads API
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
  1. Amazon Marketing Cloud
  2. AMC Audiences
  3. Rule-based audiences
  • Auth
    • Auth grant login
      GET
    • Access token from auth grant code
      POST
    • Access token from refresh token
      POST
  • Accounts
    • Profiles
      GET
    • Manager accounts
      GET
  • First call
    • List SB campaigns
      POST
    • List SD campaigns
      GET
    • List SP campaigns
      POST
  • Reporting
    • DSP report
      • Request DSP report
      • DSP report status
    • Sponsored ads V3
      • Create report
      • Report status
    • Sponsored ads V2
      • Request SB report
      • Request SD report
      • Report status
      • Download report
  • Snapshots
    • Sponsored Products
      • Request SP snapshot
      • SP snapshot status
      • Download SP snapshot
    • Sponsored Display
      • Request SD snapshot
      • SD snapshot status
      • Download SD snapshot
    • Sponsored Brands
      • Request SB snapshot
      • SB snapshot status
      • Download SB snapshot
  • Test accounts
    • Create test account
    • Check account creation status
  • Amazon Marketing Stream
    • Create Stream subscription
    • List Stream subscriptions
    • Get Stream subscription by ID
    • Update Stream subscription
  • Amazon Marketing Cloud
    • Administration
      • Accounts
        • List all AMC 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
      • Workflows
        • Create a workflow
        • Create a workflow with custom parameters
        • List all workflows in a specific instance
        • Get the requested workflow
        • Update the requested workflow
        • Delete the requested workflow
      • Schedules
        • Create a new schedule
        • List all schedules
        • Gets the requested schedule
        • Updates the requested schedule
        • Deletes the requested schedule
      • Workflow executions
        • Creates a new workflow execution
        • Returns a list of workflow executions
        • Gets status information about the requested workflow execution.
        • Updates the requested workflow execution.
        • Retrieves pre-signed url for downloading workflow execution results from S3
    • AMC Audiences
      • Rule-based audiences
        • Creates query based audience execution metadata information
          POST
        • 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
        • Creates lookalike audience execution metadata information.
  • Sponsored Products
    • Campaigns
      • List campaigns
      • Create campaigns
      • Delete campaigns
      • Update campaigns
    • Ad groups
      • Create ad groups
      • Delete ad groups
      • List ad groups
      • Update ad groups
    • Product ads
      • List product ads
      • Create product ads
      • Update product ad
      • Delete product ads
    • Product targeting
      • List targets
      • Create targets
      • Update targets
      • Delete targets
      • Product recommendatios
      • Category recommendations
    • Keywords
      • Create Keywords
      • List keywords
      • Update keywords
      • Delete keywords
      • Keyword Recommendation for existing adGroup
    • Theme-based bid recommendations
      • Get recommendations
    • Negative keywords
      • Create negative keywords
      • Update negative keywords
      • Delete negative keywords
      • List negative keywords
    • Campaign negative keywords
      • Create campaign negative keywords
      • Update campaign negative keywords
      • Delete campaign negative keywords
      • List campaign negative keywords
    • Negative targets
      • Create negative targets
      • List negative targets
      • Update negative targets
      • Delete negative targets
    • Campaign negative targets
      • Create campaign negative targets
      • List campaign negative target
      • Update campaign negative targets
      • Delete campaign negative targets
    • Budget recommendations and missed opportunities
      • Get budget recommendations and missed opportunities
    • Budget rules
      • Create budget rules
      • Associate rule to campaign
      • Get recommended events
      • Get budget rules
      • Get budget rules by campaign
      • Get budget history
  • Sponsored Brands
    • Campaigns
      • Create campaigns
      • List campaigns
      • Update campaign
      • Delete campaign
    • Ad groups
      • Create ad groups
      • List ad groups
      • List ad groups Copy
      • Update ad groups
      • Delete ad groups
    • Ads
      • Create product collection ad
      • Create product collection extended
      • Create video ad
      • Create brand video ad
      • Create store spotlight ad
      • List ads
      • Update ads
      • Delete ads
    • Targeting
      • Recommendations
        • Get product recommendations
        • Get keyword recommendations
        • Recommended categories for targeting
        • Get bid recommendations for targets
      • Theme targeting
        • Create theme targeting
        • Update theme targets
        • List themes
      • 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
      • Store spotlight
      • Brand video
      • Product collection
      • Product collection Extended
      • Video
      • List ad creatives
    • Get brands
    • Get landing page ASINS
  • Sponsored Display
    • Campaigns
      • Create campaigns
      • List campaigns
    • Ad groups
      • Create ad groups
      • Get ad groups
    • Product ads
      • Create product ads
      • Get product ads
    • Targeting
      • Create targets
      • Get targets
      • Audience taxonomy
      • Audience discovery
    • Creatives
      • Add creatives
      • List creatives
      • Update creatives
    • Locations
      • Locations
      • Locations
  • Stores
    • Get stores
    • Insight metrics
  • Product metadata
    • Get product metadata
    • Get product eligibility
  • Budget rules
    • SP
      • Create budget rules
      • Associate budget rules to campaign
      • Get recommended events
      • All budget rules
      • Update budget rules
      • Disassociate budget rule from campaign
      • Campaigns associated with a rule
      • Budget rule by ID
      • Rules associated with a campaign
    • SD
      • Create budget rules
      • Associate budget rules to campaign
      • All budget rules
      • Update budget rules
      • Disassociate budget rule from campaign
      • Campaigns associated with a rule
      • Budget rule by ID
      • Rules associated with a campaign
    • SB
      • Create budget rules
      • Associate budget rules to campaign
      • Get recommended events
      • All budget rules
      • Update budget rules
      • Disassociate budget rule from campaign
      • Campaigns associated with a rule
      • Budget rule by ID
      • Rules associated with a campaign
  • Budget usage
    • Sponsored Products
    • Sponsored Brands
    • Sponsored Display
  • Creative asset library
    • Create URL
    • Upload file
    • Register asset
    • Assets
    • Assets search
  • Locations
    • Browse locations
  • Exports
    • Request campaign export
    • Request ad group export
    • Request target export
    • Request ad export
    • Exports status
  • Sponsored TV
    • Campaign
      • Create Campaign
      • List Campaign
      • Delete Campaign
      • Update Campaign
    • AdGroup
      • Create AdGroup
      • List AdGroup
      • Update AdGroup
      • Delete AdGroup
    • Ad
      • Create Ad
      • List Ad
      • Delete Ad
      • Update Ad
    • Creatives
      • Create Creatives
      • List Creatives
      • List Creatives Moderation
      • List Creatives Moderations Policy Violations
      • Preview Creatives
  • Amazon DSP
    • Persona builder
      • Banded sizes
      • Demographics
      • Prime Video
      • Top categories purchased
      • Top overlapping audiences
  • Partner opportunities
    • List opportunities
    • Get opportunity file
  1. Amazon Marketing Cloud
  2. AMC Audiences
  3. Rule-based audiences

Get query based audience execution metadata for a given audienceExecutionId.

GET
/amc/audiences/query/{audienceExecutionId}
最后修改时间：2025-03-16 02:19:30
责任人：未设置
Returns execution metadata information for a given instanceId and audienceExecutionId.

请求参数

Path 参数
audienceExecutionId
string 
必需
(Required) Identifier that uniquely represents an AMCQueryBasedAudiencesExecutionMetadata.
示例值:
2923f36d-6188-4800-8448-a0a4038f23f6
Header 参数
Amazon-Advertising-API-ClientId
string 
必需
(Required) Identifier of a client associated with a 'Login with Amazon' account.
示例值:
{{client_id}}
Amazon-Advertising-API-EntityId
string 
必需
Identifier of an entity associated with advertising campaigns. Use GET method on amc/accounts to fetch the AMC Account ID/Entity ID.
示例值:
{{advertiser_id}}
Amazon-Marketing-Cloud-Audience-InstanceId
string 
必需
(Required) AMC Instance ID
示例值:
{{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/2923f36d-6188-4800-8448-a0a4038f23f6' \
--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}}'

返回响应

🟢200Get query based audience execution metadata for a given audienceExecutionId.
application/json
Body
advertiserId
string 
必需
advertiserType
string 
必需
audienceDescription
string 
必需
audienceExecutionId
string 
必需
audienceName
string 
必需
audienceType
string 
必需
createTime
string 
必需
instanceId
string 
必需
query
string 
必需
refreshRateDays
integer 
必需
status
string 
必需
timeWindowEnd
string 
必需
timeWindowRelative
boolean 
必需
timeWindowStart
string 
必需
示例
{
  "advertiserId": "9708102980201",
  "advertiserType": "DISPLAY",
  "audienceDescription": "Audience created for Audience Demo",
  "audienceExecutionId": "2923f36d-6188-4800-8448-a0a4038f23f6",
  "audienceName": "AMC AudienceDemo",
  "audienceType": "RULE_BASED",
  "createTime": "2024-09-25T17:43:34.808Z",
  "instanceId": "amc3dbuhjvh",
  "query": "SELECT user_id FROM amazon_attributed_events_by_conversion_time_for_audiences WHERE conversion_event_subtype = 'shoppingCart'",
  "refreshRateDays": 1,
  "status": "RUNNING",
  "timeWindowEnd": "2022-05-27T01:00:00Z",
  "timeWindowRelative": true,
  "timeWindowStart": "2022-05-25T00:00:00Z"
}
修改于 2025-03-16 02:19:30
上一页
Get all query based audiences execution metadata.
下一页
Update query based audience execution metadata for a given audienceExecutionId.
Built with