推送素材

将源广告主账户拥有的素材推送给同一广告主主体下的目标账户复用。推送不会复制素材文件，也不会生成新的素材 ID。

请求地址

https://openapi.aiclk.com/openapi/v1/material/push

所属权限

ads_write

请求方式

POST

Header: Content-Type: application/json

请求参数

Post-Body 添加参数：

字段名	类型	是否必须	描述
source_account_id	int	是	源广告主账户 ID
target_account_id	int	是	目标广告主账户 ID
material_ids	[]int	是	待推送素材 ID，重复 ID 会先去重，去重后单次最多 50 个

使用限制

当前 Access Token 必须同时拥有源账户和目标账户的访问权限，且两个账户必须属于同一广告主主体。源账户需拥有待推送素材，包括源账户自有素材和已推送给源账户的有效素材。

支持推送 IMAGE、BIG_IMAGE、LOGO、SCREEN、BANNER、HORIZONTAL_VIDEO、VERTICAL_VIDEO、HORIZONTAL_COVER、VERTICAL_COVER 类型的素材。视频和视频封面按独立素材处理，需要同时复用时请将对应素材 ID 一并传入。

请求示例

curl -X POST \
  'https://openapi.aiclk.com/openapi/v1/material/push' \
  -H 'OGW_ACCESS_TOKEN: your_access_token' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_account_id": 1000001,
    "target_account_id": 1000002,
    "material_ids": [24198456, 24198455, 37084679]
  }'

返回字段释义

字段名	类型	描述
code	int	返回码
message	string	返回信息
data	object	推送结果
- source_account_id	int	源广告主账户 ID
- target_account_id	int	目标广告主账户 ID
- success_list	[]object	推送成功的素材列表
-- material_id	int	推送成功的素材 ID
- fail_list	[]object	推送失败的素材列表
-- material_id	int	推送失败的素材 ID
-- message	string	失败原因
trace_id	string	trace ID

单个素材推送失败不影响其他素材处理。请求参数、账户授权或广告主主体校验失败时，整次请求失败。

素材失败原因

失败原因	描述
material_not_found	素材不存在
source_no_permission	源账户不拥有该素材，或已推送给源账户的素材当前无效
type_not_supported	素材类型不支持推送
resource_deleted	源账户的自有素材已删除
relation_upsert_failed	推送关系写入失败
resource_restore_failed	原始账户素材恢复失败

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "source_account_id": 1000001,
    "target_account_id": 1000002,
    "success_list": [
      {
        "material_id": 24198456
      },
      {
        "material_id": 24198455
      }
    ],
    "fail_list": [
      {
        "material_id": 37084679,
        "message": "source_no_permission"
      }
    ]
  },
  "trace_id": "72e41bfeefa2a9a"
}

同一素材重复推送到同一目标账户时，不会生成重复素材或新的素材 ID；目标账户此前删除过该推送素材时，再次推送会恢复其有效关系。