- 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 information
- Get all query based audiences execution metadata.
- Get query based audience execution metadata for a given audienceExecutionId.
- Update query based audience execution metadata for a given audienceExecutionId.
- Delete query based audience execution metadata for a given audienceExecutionId.
- Lookalike audiences
- Rule-based audiences
- Administration
- 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
- SP
- SD
- SB
- Budget usage
- Creative asset library
- Locations
- Exports
- Sponsored TV
- Amazon DSP
- Partner opportunities
Update budget rules
PUT
/sp/budgetRules
最后修改时间：2025-03-16 02:19:30
责任人：未设置
请求参数
Header 参数
Amazon-Advertising-API-ClientId
string
必需
示例值:
{{client_id}}
Authorization
string
必需
示例值:
Bearer {{access_token}}
Amazon-Advertising-API-Scope
string
必需
示例值:
{{profileId}}
Accept
string
必需
示例值:
application/json
Body 参数text/plain
示例
示例值:{
"budgetRulesDetails": [
{
"lastUpdatedDate": null,
"ruleDetails": {
"ruleType": "PERFORMANCE",
"name": "Spring Budget Rule - Updated",
"duration": {
"dateRangeTypeRuleDuration": {
"startDate": "20230220",
"endDate": "20230308"
}
},
"recurrence": {
"type": "DAILY"
},
"budgetIncreaseBy": {
"type": "PERCENT",
"value": 75
},
"performanceMeasureCondition": {
"metricName": "ROAS",
"comparisonOperator": "GREATER_THAN_OR_EQUAL_TO",
"threshold": 2.0
}
},
"ruleId": "{{budgetRuleId}}",
"ruleState": "ACTIVE",
"ruleStatus": "ACTIVE",
"ruleStatusDetails": null
}
]
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://www.amazon.com/ap/oa/sp/budgetRules' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Amazon-Advertising-API-Scope: {{profileId}}' \
--header 'Accept: application/json' \
--header 'Content-Type: text/plain' \
--data-raw '{
"budgetRulesDetails": [
{
"lastUpdatedDate": null,
"ruleDetails": {
"ruleType": "PERFORMANCE",
"name": "Spring Budget Rule - Updated",
"duration": {
"dateRangeTypeRuleDuration": {
"startDate": "20230220",
"endDate": "20230308"
}
},
"recurrence": {
"type": "DAILY"
},
"budgetIncreaseBy": {
"type": "PERCENT",
"value": 75
},
"performanceMeasureCondition": {
"metricName": "ROAS",
"comparisonOperator": "GREATER_THAN_OR_EQUAL_TO",
"threshold": 2.0
}
},
"ruleId": "{{budgetRuleId}}",
"ruleState": "ACTIVE",
"ruleStatus": "ACTIVE",
"ruleStatusDetails": null
}
]
}'返回响应
🟢207Update rule state
application/json
Body
responses
array [object {4}]
必需
associatedCampaignIds
array[string]
可选
code
string
可选
details
string
可选
ruleId
string
可选
示例
{
"responses": [
{
"associatedCampaignIds": [
"102028944323821"
],
"code": "Ok",
"details": "Budget rule updated",
"ruleId": "f1eded08-af77-454a-b307-7783802657e2"
}
]
}🟢207Update name, end date, increase value
修改于 2025-03-16 02:19:30