Amazon Ads API
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
  1. Schedules
  • 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
          POST
        • List all schedules
          GET
        • Gets the requested schedule
          GET
        • Updates the requested schedule
          PUT
        • Deletes the requested schedule
          DELETE
      • 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
        • 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
        • 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. Schedules

Gets the requested schedule

GET
/amc/reporting/{{instanceId}}/schedules/{scheduleId}
最后修改时间：2025-03-16 02:19:30
责任人：未设置
Gets the requested schedule. Schedules are used to specify the periodic execution of a given workflow, on either a daily or weekly cadence.

请求参数

Path 参数
scheduleId
string 
必需
示例值:
my-first-schedule
Header 参数
Amazon-Advertising-API-ClientId
string 
必需
(Required) The identifier of a client associated with an Amazon Developer account.
示例值:
{{client_id}}
Amazon-Advertising-API-MarketplaceId
string 
必需
(Required) The marketplace identifier for the marketplace in the request. Marketplaces are tied to the country.
示例值:
{{marketplace_id}}
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.
示例值:
{{advertiser_id}}
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 -g --request GET 'https://advertising-api.amazon.com/amc/reporting/{{instanceId}}/schedules/my-first-schedule' \
--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}}'

返回响应

🟢200Gets the requested schedule
application/json
Body
aggregationHourUtc
integer 
必需
aggregationPeriod
string 
必需
aggregationStartDay
string 
必需
disableAggregationControls
boolean 
必需
requireSyntheticData
boolean 
必需
scheduleEnabled
boolean 
必需
scheduleId
string 
必需
workflowId
string 
必需
示例
{
    "aggregationHourUtc": 14,
    "aggregationPeriod": "Weekly",
    "aggregationStartDay": "Monday",
    "disableAggregationControls": true,
    "requireSyntheticData": true,
    "scheduleEnabled": true,
    "scheduleId": "my-first-schedule",
    "workflowId": "my-first-workflow"
}
修改于 2025-03-16 02:19:30
上一页
List all schedules
下一页
Updates the requested schedule
Built with