# 设置小程序用户隐私保护指引

调试诊断

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：setPrivacySetting

• 本接口用于配置第三方代开发小程序的用户隐私保护指引。可根据小程序实际情况进行完善。小程序发布后即向c端用户展示。

• 配置小程序用户隐私保护指引查看介绍

• 使用过程中如遇到问题，可在开放平台服务商专区发贴交流

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/component/setprivacysetting?access_token=ACCESS_TOKEN

# 云调用

• 本接口不支持云调用

# 第三方调用

• 本接口支持第三方平台代商家调用。

• 该接口所属的权限集 id 为：18

• 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# Body.setting_list(Array) Object Payload

要收集的用户信息配置，可选择的用户信息类型参考下方详情。当privacy_ver传2或者不传时，setting_list是必填；当privacy_ver传1时，该参数不可传，否则会报错

# Body.owner_setting Object Payload

收集方（开发者）信息配置

# Body.sdk_privacy_info_list(Array) Object Payload

该小程序中引用了第三方sdk的信息说明

# Body.sdk_privacy_info_list(Array).sdk_listObject Payload

sdk收集的信息以及用途

# 3. 返回参数

# 返回体 Response Payload

# 4. 注意事项

1、通过该接口配置用户隐私保护指引后，对于线上版本的小程序生效，则需重新提交代码审核，审核通过且需要重新发布上线后才会在小程序端生效；而对于开发版或者体验版的小程序，则设置后，即可根据设置的隐私协议内容直接调用对应的接口，且展示的隐私协议内容与在开发版或者体验版设置的内容一致（即与线上版的不一致，线上版的如果要生效得提交代码审核，审核通过且需要重新发布上线后才会在小程序端生效）

2、通过该接口配置用户隐私保护指引后，可通过查询最新一次提交的审核状态接口查询审核的状态，如果是驳回了则可以查看驳回原因。

3、传参时注意不要 json_encode 中文变成了unicode编码，否则在小程序端会展示成乱码。建议set成功之后，调get接口看下设置的中文是否正常被显示。

4、境外主体小程序需要补充「用户隐私保护指引」中「存储地区」的相关信息，否则小程序审核会被驳回。

# 其他说明

# 参数补充说明

1、开发版指的是通过setprivacysetting接口已经配置的用户隐私保护指引内容，但是还没发布到现网，还没正式生效的版本。

2、现网版本指的是已经在小程序现网版本已经生效的用户隐私保护指引内容。

3、如果小程序已有一个现网版，可以通过该接口（privacy_ver=1）直接修改owner_setting里除了ext_file_media_id之外的信息，修改后即可生效。

4、如果需要修改其他信息，则只能修改开发版（privacy_ver=2），然后提交代码审核，审核通过之后发布生效。

5、当该小程序还没有现网版的隐私保护指引时却传了privacy_ver=1，则会出现 86074 报错

# privacy_key 可选值如下

• 该列表后续可能会有新增，可通过查询小程序用户隐私保护指引接口获取最新的信息。
• 以下列表的中文描述可能会有所调整，以查询小程序用户隐私保护指引接口获取的为准

# store_region 可选值

# 5. 代码示例

请求示例

{
    "owner_setting" : {
       "contact_email" : "contact_email",
       "contact_phone" : "contact_email",
       "contact_qq" : "contact_qq",
       "contact_weixin" : "contact_weixin",
       "ext_file_media_id" : "2113706500236918784",
       "notice_method" : "notice_method",
       "store_expire_timestamp" : "store_expire_timestamp"
    },
    "setting_list" : [
       {
          "privacy_key" : "privacy_key",
          "privacy_text" : "privacy_text"
       },
       {
          "privacy_key" : "privacy_key",
          "privacy_text" : "privacy_text"
       }
    ],
    "sdk_privacy_info_list":[
        {
            "sdk_name":"测试sdk",
            "sdk_biz_name":"小麦有限公司",
            "sdk_list":[
                {
                    "privacy_key":"头像信息",
                    "privacy_text":"用来展示你的美貌"
                }
                
            ]
        }
    ],
    "privacy_ver":2,
 }

返回示例

{
  "errcode": 0,
  "errmsg": "ok"
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

# 7. 适用范围

本接口支持「第三方平台」账号类型代调用，权限集请参考「调用方式」部分。其他账号类型如无特殊说明，均不可调用。