操作 （字符串）
必填 - 始终必填。
|要对提供的素材详情执行的操作。
允许的值：
CREATE, UPDATE, DELETE.
ProgramId （整数）
必填 - 始终必填。
| 素材所属的 impact.com Program ID 唯一标识。此值无法更新，且必须与执行批量上传的 program 一致。 | |AdID （字符串）
必填 - 对现有素材执行操作时。
| 素材的 impact.com 唯一标识。创建新素材时留空。如果 *操作* = `UPDATE`, `DELETE`. | |状态 （字符串）
必填 - 否。
|素材的状态。
允许的值：
ACTIVE, PENDING, EXPIRED.
名称 （字符串）
必填 - 创建素材时。
| *素材名称*。如果 *操作* = `CREATE`. | |AdType （字符串）
必填 - 创建素材时。
|更新现有广告时，广告类型不可更改。
如果 操作 = CREATE.
允许的值：
IMAGE, TEXT\_LINK, COUPON.
HostedBy （字符串）
必填 - 创建素材时。
|素材创意的托管位置。如果
操作 = CREATE 和 AdType = IMAGE.
允许的值：
IR, 网址, HTML.
Creative （字符串）
必填 - 创建图片素材时。
|要上传的创意文件名称。如果
操作 = CREATE 和 AdType = IMAGE.
IabAdUnit （字符串）
必填 - 创建图片素材时。
|IAB 标准素材尺寸。如果 操作 =
CREATE 和 AdType = IMAGE 和 HostedBy != IR.
允许的值： UNKNOWN, MEDIUM\_RECTANGLE, SQUARE\_POP\_UP, VERTICAL\_RECTANGLE, LARGE\_RECTANGLE, RECTANGLE, RECTANGLE\_3\_1\_, POP\_UNDER, FULL\_BANNER, HALF\_BANNER, MICRO\_BANNER, BUTTON\_1, BUTTON\_2, VERTICAL\_BANNER, SQUARE\_BUTTON, LEADERBOARD, WIDE\_SKYSCRAPER, SKYSCRAPER, HALF\_PAGE\_AD, CUSTOM.
ThirdPartyServableAdCreativeHeight （整数）
必填 - 创建图片素材时。
|第三方可投放图片高度，像素。
如果 操作 = CREATE 和 IabAdUnit =
CUSTOM.
ThirdPartyServableAdCreativeWidth （整数）
必填 - 创建图片素材时。
|第三方可投放图片宽度，像素。
如果 操作 = CREATE 和 IabAdUnit =
CUSTOM.
语言 （字符串）
必填 - 创建素材时。
|允许的值：
AFRIKAANS, ARABIC, BULGARIAN, CHINESE, CHINESE\_TRADITIONAL, CZECH, DANISH, DUTCH, ENGLISH, ENGLISH\_GB, ENGLISH\_AU, ENGLISH\_CA, ENGLISH\_NZ, ENGLISH\_ZA, ESTONIAN, FILIPINO, FINISH, FRENCH, FRENCH\_CA, GERMAN, HEBREW, HINDI, INDONESIAN, ITALIAN, JAPANESE, KOREAN, LATVIAN, LITHUANIAN, MALAY, MALTESE, NORWEGIAN, PORTUGUESE, PORTUGUESE\_BR, POLISH, RUSSIAN, SLOVENIAN, SPANISH, SPANISH\_MX, SWEDISH, THAI, TURKISH, VIETNAMESE.
LimitedTimeEndDate （日期）
必填 - 如果提供了 LimitedTimeStartDate
| 这是一个 ISO8601 日期。示例格式： `2013-06-30T00:00:00-07:00`. | |LinkText （字符串）
必填 - 创建文本链接或优惠券素材时。
| 链接显示的实际文本。如果 *操作* = `CREATE` 和 *AdType* = `TEXT_LINK` 或 `COUPON`. | |说明
必填 - 否。
| 素材描述。 | |标签 （CSV 字符串）
必填 - 否。
| 素材标签。 | |AllowDeepLinking （布尔值）
必填 - 否。
|决定是否允许链接到广告主网站内更深层页面。
默认为 true.
AllowCustomPromoCode （布尔值）
必填 - 否。
|允许合作伙伴为此促销请求其自己的唯一促销代码。
默认为 false.
CustomisationCharge （十进制 10.2）
必填 - 否。
| 素材自定义收费金额。 | |ImageAlternativeTag （字符串）
必填 - 否。
| 在图片素材代码中使用的替代标签。 | |LandingPage （字符串）
必填 - 否。
|落地页 URL。必须包含 URL 协议。
创建素材且未提供时，默认为 program 的默认落地页。
| |iOSMobileFallbackAppId （字符串）
必填 - 否。
| 如果未检测到应用，请指定移动流量是否回退到你的 iOS 应用落地页。App id 必须与系统 app id 匹配。 | |AndroidMobileFallbackAppId （字符串）
必填 - 否。
| 如果未检测到应用，请指定移动流量是否回退到你的 Android 应用落地页。App id 必须与系统 app ID 匹配。 | |LimitedTimeStartDate （字符串）
必填 - 否。
| 这是一个 ISO8601 日期。示例格式： `2013-06-30T00:00:00-07:00`. | |FallbackAd （字符串）
必填 - 否。
| 指定回退素材 ID，仅适用于 `IMAGE` 素材。 | |GetHtmlCodeType （字符串）
必填 - 否。
| 允许的值： `IFRAME_ONLY`, `HTML_AND_IFRAME`. | |Season （字符串）
必填 - 否。
|允许的值：
WINTER, SPRING, SUMMER, FALL, NEW\_YEAR, PRESIDENTS\_DAY, VALENTINES\_DAY, ST\_PATRICKS\_DAY, EASTER, MOTHERS\_DAY, MEMORIAL\_DAY, FATHERS\_DAY, INDEPENDANCE\_DAY, BACK\_TO\_SCHOOL, LABOR\_DAY, HALLOWEEN, THANKSGIVING, BLACK\_FRIDAY, CYBER\_MONDAY, HANUKKAH, CHRISTMAS, FAMILY\_DAY, GOOD\_FRIDAY, VICTORIA\_DAY, CANADA\_DAY, AUGUST\_CIVIC\_HOLIDAY, REMEMBRANCE\_DAY, BOXING\_DAY, AUSTRALIA\_DAY, ANZAC\_DAY, QUEENS\_BIRTHDAY, END\_OF\_FINANCIAL\_YEAR, WAITANGI\_DAY, OTHER.
TopSeller （布尔值）
必填 - 否。
| 畅销商品。默认为 `false`. | |ThirdPartyImpressionPixel （字符串）
必填 - 否。
| 与此素材一起使用的第三方展示像素 HTML。 | |RestrictedToPartners （CSV 字符串）
必填 - 否。
| 应可访问此素材的合作伙伴 ID，以逗号分隔。 | |RestrictedToGroups （CSV 字符串）
必填 - 否。
| 应可访问此素材的合作伙伴组 ID，以逗号分隔。 | |元数据 （CSV 字符串）
必填 - 否。
| 将附加到跟踪 URL 的查询字符串参数，以逗号分隔。 |DealName （字符串）
必填 - 创建新交易时。
| 要创建并链接到素材的交易名称。如果 *DealId* 未提供。 | |DealType （字符串）
必填 - 创建新交易时。
|要创建的交易类型。如果 DealId 未提供且 DealName 已提供，则为必填。
允许的值：
GENERAL\_SALE,FREE\_SHIPPING, GIFT\_WITH\_PURCHASE, REBATE, 买一送一, PRODUCT\_LAUNCH.
DealScope （字符串）
必填 - 创建新交易时。
|如果 DealId 未提供， DealName 为，且 DealType != BOGO。
允许的值：
ENTIRE\_STORE, CATEGORY, PRODUCT, PRODUCTS.
DealProducts （CSV 字符串）
必填 - 创建新交易时。
|交易产品。如果 DealId 未提供， DealName 为，且 DealScope = PRODUCT.
允许的值：
选项 1：产品名称列表，例如 "Product1, Product2".
选项 2：产品键值对列表，例如 "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" 其中多个产品之间以逗号分隔，各产品字段之间以分号分隔。
有效字段： 名称 - 产品名称， image - 你计划在批量上传第二步中上传的文件的产品图片文件名， limit - 允许数量， regularPrice - 折扣前价格， dealPrice - 折扣后价格。
DealCategories （CSV 字符串）
必填 - 创建新交易时。
| 交易类别。如果 *DealId* 未提供， *DealName* 为，且 *DealScope* = `CATEGORY`. | |DealLandingPage（字符串）
必填 - 否
DealMetadata（CSV 字符串）
必填 - 否
DealAllowDeepLinking（布尔值）
必填 - 否
DealDiscountType （CSV 字符串）
必填 - 创建新交易时。
|如果 DealId 未提供， DealName 为，且 DealType = GENERAL\_SALE。
允许的值：
FIXED, PERCENT, PERCENT\_RANGE, PERCENT\_MAXIMUM.
DealDiscountAmount （十进制 10.2）
必填 - 创建新交易时。
| 促销折扣金额。如果 *DealId* 未提供， *DealName* 为， *DealType* = `GENERAL_SALE`，以及 *DealDiscountType* = `FIXED`. | |DealDiscountPercent （十进制 10.2）
必填 - 创建新交易时。
| 促销折扣百分比。如果 *DealId* 未提供， *DealName* 为， *DealType* = `GENERAL_SALE`，以及 *DealDiscountType* = `PERCENT`. | |DealDiscountStartPercent （十进制 10.2）
必填 - 创建新交易时。
| 交易折扣范围起始百分比。如果 *DealId* 未提供， *DealName* 为， *DealType* = `GENERAL_SALE`，以及 *DealDiscountType* = `PERCENT_RANGE`. | |DealDiscountEndPercent （十进制 10.2）
必填 - 创建新交易时。
| 交易折扣范围起始百分比。如果 *DealId* 未提供， *DealName* 为， *DealType* = `GENERAL_SALE`，以及 *DealDiscountType* = `PERCENT_RANGE`. | |DealDiscountMaximumPercent （十进制 10.2）
必填 - 创建新交易时。
| 交易最大折扣百分比。如果 *DealId* 未提供， *DealName* 为， *DealType* = `GENERAL_SALE`，以及 *DealDiscountType* = `PERCENT_MAXIMUM`. | |DealGift （十进制 10.2）
必填 - 创建新交易时。
| 赠品详情。如果 *DealId* 未提供， *DealName* 为，且 *DealType* = `GIFT_WITH_PURCHASE`. | |DealRebate （十进制 10.2）
必填 - 创建新交易时。
| 返利金额。如果 *DealId* 未提供， *DealName* 为，且 *DealType* = `REBATE`. | |DealMinimumPurchaseAmount （十进制 10.2）
必填 - 创建新交易时。
| 交易最低购买金额。如果 *DealId* 未提供， *DealName* 为，且 *DealType* = `买一送一`. | |DealMaximumSavingsAmount （十进制 10.2）
必填 - 创建新交易时。
| 交易最高节省金额。如果 *DealId* 未提供， *DealName* 为，且 *DealType* = `买一送一`. | |DealBogoPurchaseLimit （整数）
必填 - 创建新交易时。
| 此价格下允许的商品最大数量。如果 *DealId* 未提供， *DealName* 为，且 *DealType* = `买一送一`. | |DealBogoBuyQty （整数）
必填 - 创建新交易时。
| BOGO 购买数量。如果 *DealId* 未提供， *DealName* 为，且 *DealType* = `买一送一`. | |DealBogoBuyType （字符串）
必填 - 创建新交易时。
|BOGO 购买项目类型。如果 DealId 未提供， DealName 为，且 DealType = 买一送一.
允许的值：
PRODUCT, CATEGORY.
DealBogoBuyName （字符串）
必填 - 创建新交易时。
| 购买产品或类别名称。如果 *DealId* 未提供， *DealName* 为，且 *DealType* = `买一送一`. | |DealBogoGetQty （整数）
必填 - 创建新交易时。
| BOGO 获得数量。如果 *DealId* 未提供， *DealName* 为，且 *DealType* = `买一送一`. | |DealBogoGetType （字符串）
必填 - 创建新交易时。
|BOGO 获得项目类型。如果 DealId 未提供， DealName 为，且 DealType = 买一送一.
允许的值：
PRODUCT, CATEGORY.
DealBogoGetName （字符串）
必填 - 创建新交易时。
| 获得产品或类别名称。如果 *DealId* 未提供， *DealName* 为，且 *DealType* = `买一送一`. | |DealBogoGetDiscountType （字符串）
必填 - 创建新交易时。
|BOGO 交易折扣类型。如果 DealId 未提供， DealName 为，且 DealType = 买一送一.
允许的值：
FREE, AMOUNT, PERCENT.
DealBogoGetDiscountAmount （十进制 10.2）
必填 - 创建新交易时。
| BOGO 交易折扣金额。如果 *DealId* 未提供， *DealName* 为， *DealType* = `买一送一`，以及 *DealBogoGetDiscountType* = `AMOUNT`. | |DealBogoGetDiscountPercent （十进制 10.2）
必填 - 创建新交易时。
| BOGO 交易折扣百分比。如果 *DealId* 未提供， *DealName* 为， *DealType* = `买一送一`，以及 *DealBogoGetDiscountType* = `PERCENT`. | |DealId （字符串）
必填 - 否。
| 交易的 impact.com 唯一标识，素材将链接到该交易。 | |DealDefaultDiscountCode （字符串）
必填 - 否。
| 默认交易折扣码。 | |DealSyncAdsPromoCodes （布尔值）
必填 - 否。
| 使关联广告和促销代码与此交易保持同步。同步适用于限时日期、受限合作伙伴访问权限和状态。 |