You need to enable JavaScript to run this app.
导航
创建数据删除Job
最近更新时间:2025.10.29 11:32:22首次发布时间:2025.06.13 14:01:53
复制全文
我的收藏
有用
有用
无用
无用

注意事项
  • 可以混合使用user_unique_id和ssid,一次最多可以指定100个用户。用户数以去重后数量为准。
  • 同一应用最多只能同时执行一个用户数据删除Job。
  • 仅私有化5.2.0及以上版本可正常使用删除用户数据相关OpenAPI。

创建用户数据删除job

Path/openapi/v1/{app_id}/data-deletions
Method: POST
请求参数:

  • 请求参数

    字段

    类型

    必填

    说明

    uuids

    array

    false

    要删除的user_unique_id列表

    ssids

    array

    false

    要删除的ssid列表,与uuids必选其一。如果都传会将uuid转成ssid并进行merge

  • 请求示例:

    {
        "uuids": ["user-1@test.com", "user-2@test.com"],
        "ssids": ["6f67ea5e-69ee-48bc-a75a-******", "990c4961-3c84-4d19-87d3-7******"]
    }
    

    说明

    以上为删除4个用户的请求示例。同时上传了2个uuis和2个ssid,最终执行用户数据删除时,会将2个uuid分别转为ssid,与已上传的2个ssid,merge后去重,最终执行删除的用户数为4个。

Response

{
    "code": 200,
    "message": "ok",
    "data": #/schemas/DeletionJob
}

调用示例
def create_deletion_job():
    ak = "{YOUR_AK}"
    sk = "{YOUR_SK}"
    client = RangersClient(ak, sk, url="https://datarangers.com")
    
    resp = client.data_finder("/openapi/v1/181902/data-deletions", method="post", body={"ssids": ["5be111b2-83c9-44ff-8942-******","0b419397-08fb-4570-9c66-******5"], "uuids": ["139124******","986170174920******"]})
    print(resp.json())