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

调试工具

接口应在服务器端调用，详细说明参见服务端API。

# 接口说明

# 接口英文名

setPrivacySetting

# 功能描述

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

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

# 注意事项

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

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

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

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

# 调用方式

# HTTPS 调用

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

# 第三方调用

• 调用方式以及出入参和HTTPS相同，仅是调用的token不同

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

• 服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

# 返回参数

# 其他说明

# 参数补充说明

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

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

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

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

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

# privacy_key 可选值如下

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

# store_region 可选值

# 调用示例

示例说明: HTTPS请求

# 请求数据示例

{
    "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"
  } 

# 错误码