dmp-cli — DMP 命令行界面（CLI）

DMP CLI 当任务需要操作Mingdata DMP CLI时使用此技能。 快速开始 验证CLI是否安装：dmp version # 或 dmp --version 如果CLI缺失，从GitHub Releases下载并安装： # 检测平台 OS=$(uname -s | tr '[:upper:]' '[:lower:]') # linux或darwin ARCH=$(uname -m) [ "$ARCH" = "x86_64" ] && ARCH="amd64" [ "$ARCH" = "aarch64" ] && ARCH="arm64" # 获取最新发布标签 TAG=$(curl -sf https://api.github.com/repos/a652/dmp-cli/releases/latest | grep '"tag_name"' | cut -d'"' -f4) # 下载二进制文件 FILENAME="dmp-${TAG}-${OS}-${ARCH}" curl -fL "https://github.com/a652/dmp-cli/releases/download/${TAG}/${FILENAME}" -o /usr/local/bin/dmp chmod +x /usr/local/bin/dmp 发布页面：https://github.com/a652/dmp-cli/releases 可用平台：linux/amd64、linux/arm64、darwin/amd64、darwin/arm64、windows/amd64 在运行数据命令之前配置DMP上下文： DMP_SECRET_KEY= dmp config set-context \ --url https://dmp-api.example.com \ --access-key dmp config use-context 验证配置： dmp config current-context -o json dmp config list -o json 何时使用 用户需要创建、检查或管理DMP受众。 用户需要创建或检查DMP洞察任务。 用户需要将DMP受众同步到媒体平台。 用户需要创建或修改RTQ交易。 用户需要DMP参考数据用于标签、应用程序、区域或广告维度。 用户需要配置或验证dmp CLI环境。 先决条件 dmp二进制文件已安装并在PATH中。 DMP上下文在~/.dmp/config.yaml中配置，或者提供等效的环境变量覆盖。 对于非交互式使用，凭据必须通过环境变量提供。 所需环境变量 变量 描述 DMP_SECRET_KEY 明文密钥。非TTY环境中配置set-context所需。 DMP_UPLOAD_PASSWORD S3上传密码。创建受众上传S3和创建受众转换所需。 DMP_API_URL 可选API URL覆盖。 DMP_ACCESS_KEY 可选访问密钥覆盖。 DMP_CONTEXT 可选上下文名称覆盖。 如果配置详细信息缺失，请不要猜测。告诉用户联系Mingdata DMP团队（product@mingdata.com）以获取API URL、访问密钥、密钥、上下文详细信息或上传密码。 输出契约 在程序中解析命令输出时使用-o json。 捕获单个标量值（如ID）时使用-o plain。 标量命令（如dmp version、dmp --version、dmp config current-context、dmp config set-context和dmp config use-context）返回一个逻辑值。 创建命令返回创建的ID字段，格式一致。 使用-o json，标量命令返回结构化对象（如{"version":"dev"}或{"currentContext":"dev"}）。 使用-o plain，标量命令返回裸值，位于一行。 使用-o table，标量命令返回一列表。 使用-o json，创建命令返回完整的API响应有效负载（如{"audienceId":123}或{"taskId":456}）。 使用-o plain，创建命令返回创建的ID。 使用-o table，创建命令返回一列表，包含创建的ID。 错误处理 退出代码0：成功。 退出代码1：API错误。 退出代码2：客户端或验证错误。 退出代码3：网络错误。 在非TTY环境中，错误通过stderr以JSON格式发出，包含error_code和message字段。 进程退出代码不在stderr JSON有效负载中重复。 配置验证 dmp config current-context -o json返回：{"currentContext":"dev"} dmp config list -o json返回：{"currentContext":"dev","contexts":[{"name":"dev","apiUrl":"https://dmp-api.example.com","accessKey":"ak","current":true}]} 代理指南 受众创建是异步的。在创建后，轮询dmp audience status，直到audienceStatus为1或0。 在调用dmp sync create之前，始终使用dmp sync advertisers --platform 解析广告商ID。 在CI或代理工作流中，通过环境变量设置凭据。不要依赖交互式提示。 对于复杂的JSON有效负载，使用@filename输入代替长内联shell字符串。 在构建基于规则的受众之前，查询dmp ref数据以获取有效的维度、应用程序、区域或标签。 对于交易修改，只包含更改的字段。audiences是追加的。 其他参考 完整的安装、配置、命令和输出示例：references/commands.md 常见的端到端代理工作流：references/workflows.md