eBay · Schema

CreateUserScheduleRequest

The type that defines the fields for the createSchedule method.

AuctionsCommerceProductsMarketplaceFortune 500

Properties

Name Type Description
feedType string The name of the feed type for the created schedule.

Use the getScheduleTemplates method to retrieve the feed t
preferredTriggerDayOfMonth integer The preferred day of the month to trigger the schedule. This field can be used with preferredTriggerHour for monthly schedules. The last day of the month is used for numbers larger th
preferredTriggerDayOfWeek string The preferred day of the week to trigger the schedule. This field can be used with preferredTriggerHour for weekly schedules.

This field is available as specified by the t
preferredTriggerHour string The preferred two-digit hour of the day to trigger the schedule.

This field is available as specified by the template (scheduleTemplateId). The template can specify this f
scheduleEndDate string The timestamp on which the report generation (subscription) ends. After this date, the schedule status becomes INACTIVE.

Use this field, if available, to end the schedule in t
scheduleName string The schedule name assigned by the user for the created schedule.
scheduleStartDate string The timestamp to start generating the report. After this timestamp, the schedule status becomes active until either the scheduleEndDate occurs or the scheduleTemplateId
scheduleTemplateId string The unique identifier of the template to be used for this schedule.

Use the getScheduleTemplates method to ret
schemaVersion string The schema version of a schedule.
View JSON Schema on GitHub

JSON Schema

ebay-createuserschedulerequest-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/CreateUserScheduleRequest",
  "title": "CreateUserScheduleRequest",
  "type": "object",
  "properties": {
    "feedType": {
      "type": "string",
      "description": "The name of the feed type for the created schedule.<br><br> Use the <a href=\"/api-docs/sell/feed/resources/schedule/methods/getScheduleTemplates\">getScheduleTemplates</a> method to retrieve the feed type of a schedule template.<br><br><span class=\"tablenote\"><b>Note:</b> Schedules are currently only available for <code>LMS_ORDER_REPORT</code>.</span>"
    },
    "preferredTriggerDayOfMonth": {
      "type": "integer",
      "description": "The preferred day of the month to trigger the schedule. This field can be used with <strong>preferredTriggerHour</strong> for monthly schedules. The last day of the month is used for numbers larger than the actual number of days in the month. <br /><br />This field is available as specified by the template (<strong>scheduleTemplateId</strong>). The template can specify this field as optional or required, and optionally provides a default value.<br /><br /><b>Minimum: </b>1<br /><br /><b>Maximum: </b>31",
      "format": "int32"
    },
    "preferredTriggerDayOfWeek": {
      "type": "string",
      "description": "The preferred day of the week to trigger the schedule. This field can be used with <strong>preferredTriggerHour</strong> for weekly schedules. <br /><br />This field is available as specified by the template (<strong>scheduleTemplateId</strong>). The template can specify this field as optional or required, and optionally provides a default value. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/feed/types/api:DayOfWeekEnum'>eBay API documentation</a>"
    },
    "preferredTriggerHour": {
      "type": "string",
      "description": "The preferred two-digit hour of the day to trigger the schedule. <br /><br />This field is available as specified by the template (<strong>scheduleTemplateId</strong>). The template can specify this field as optional or required, and optionally provides a default value.<br /><br /><b>Format:</b> UTC <code>hhZ</code><br /><br />For example, the following represents 11:00 am UTC:<code> 11Z</code>"
    },
    "scheduleEndDate": {
      "type": "string",
      "description": "The timestamp on which the report generation (subscription) ends. After this date, the schedule status becomes <code>INACTIVE</code>. <br /><br />Use this field, if available, to end the schedule in the future. This value must be later than <strong>scheduleStartDate</strong> (if supplied). This field is available as specified by the template (<strong>scheduleTemplateId</strong>). The template can specify this field as optional or required, and optionally provides a default value.<br /><br /><b>Format:</b> UTC <code>yyyy-MM-dd<strong>T</strong>HH<strong>Z</strong></code><br /><br />For example, the following represents UTC October 10, 2021 at 10:00 AM:<br /><code>2021-10-10T10Z</code>"
    },
    "scheduleName": {
      "type": "string",
      "description": "The schedule name assigned by the user for the created schedule."
    },
    "scheduleStartDate": {
      "type": "string",
      "description": "The timestamp to start generating the report. After this timestamp, the schedule status becomes active until either the <strong>scheduleEndDate</strong> occurs or the <strong>scheduleTemplateId</strong> becomes inactive. <br /><br />Use this field, if available, to start the schedule in the future but before the <strong>scheduleEndDate</strong> (if supplied). This field is available as specified by the template <strong>(scheduleTemplateId)</strong>. The template can specify this field as optional or required, and optionally provides a default value.<br /><br /><b>Format:</b> UTC <code>yyyy-MM-dd<strong>T</strong>HH<strong>Z</strong></code><br /><br />For example, the following represents a schedule start date of UTC October 01, 2020 at 12:00 PM:<br /><code> 2020-01-01T12Z</code>"
    },
    "scheduleTemplateId": {
      "type": "string",
      "description": "The unique identifier of the template to be used for this schedule. <br><br>Use the <a href=\"/api-docs/sell/feed/resources/schedule/methods/getScheduleTemplates\">getScheduleTemplates</a> method to retrieve the schedule template ID. This method requires a schedule template ID that is <code>ACTIVE</code>.<br><br><span class=\"tablenote\"><b>Note:</b> Schedules are currently only available for <code>LMS_ORDER_REPORT</code>.</span>"
    },
    "schemaVersion": {
      "type": "string",
      "description": "The schema version of a schedule."
    }
  },
  "description": "The type that defines the fields for the <strong>createSchedule</strong> method."
}