服务端集成 · 报表查询 · 素材信息查询

说明如何通过 Gravity Engine OpenAPI 查询媒体素材与 Gravity Engine 本地素材之间的关联关系，涵盖认证、请求参数、筛选条件和返回字段。

此接口用于查询媒体素材与引力本地素材的关联关系。

申请引力开发者应用

在正式接入本接口之前，您需要在引力后台-引力开发者页面申请引力开发者应用，申请之后，我们将在一个工作日内完成审核，审核通过之后，您的开发者应用才可以正常拉取数据。

创建好开发者应用之后，请复制 app_key 参数，并发送给研发同学以供后续接口调用使用。

接口信息

请求地址

https://api-insight.gravity-engine.com/openapi/api/v1/material/id_map/

请求方法

POST

字段	类型	描述
Authorization	string	具体如何生成，请参考【签名生成】

body 参数

参数名	必填	类型	说明	描述
`ad_platform`	Y	string	媒体平台	取值参考【广告平台枚举值】
`material_id_list`	Y	string[]	媒体素材 ID	对应媒体平台的素材 ID
`sign`	Y	string	签名	详情请参考【签名生成】

请求示例

curl 'https://api-insight.gravity-engine.com/openapi/api/v1/material/id_map/' \
-H 'Content-Type: application/json' \
-H 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfa2V5IjoiYmY5YjNhZjU2ZDNkNGM5ZDkyZTFhYmNlMDYxmGQwNWQifQ.nIamPAHCSwThBAwI_cfWAcPRIjoATPvF_2i0VTEn-V0' \
-d '{
    "ad_platform": "bytedance",
    "material_id_list": ["6995736329645490187", "6994682342909165605"],
    "sign": "17aae8b72954500bc7265200023d01f1"
}'

应答示例

{
    "data": {
        "6994682342909165605": 7948170452537344,
        "6995736329645490187": 7948170992553984
    },
    "extra": {
        "error": "",
        "request_id": "39a6650a78224d568ed10e9fc15bf65d"
    },
    "code": 0,
    "msg": "成功"
}

素材信息查询