ユーザータグ管理
ユーザータグ管理
開発者は、ユーザー タグ管理の関連インターフェイスを使用して、公開アカウントのタグを作成および作成できます。ラベル付けやラベル付け解除などのクエリ、変更、削除などの操作もユーザーに対して実行できます。
#タグ管理
##1. タグの作成 #公開アカウントは最大 100 個のタグを作成できます。
#インターフェイス呼び出しリクエストの説明
#http リクエスト メソッド: POST (https プロトコルを使用してください)https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKENPOST データ形式: JSONPOST データの例: { "タグ" : { "名前" : "広東"//タグ名 }} パラメータの説明
パラメータ 説明 access_token 呼び出しインターフェース認証情報 name タグ名 (30 文字以内) 戻り値の説明(正常時に返されるjsonデータパケットの例)
##{ "tag":{
"id":134,//タグid"name":"広東" }} 戻りパラメータの説明
パラメータ 説明 #id WeChat によって割り当てられたタグ ID name タグ名、UTF8 エンコーディング #エラー コードの説明
エラー コード 説明 -1 システムがビジーです ##45157タグ名が不正です。ご注意ください。他のタグと複製するには 名前 45158タグ名の長さが 30 バイトを超えています 45056作成されたタグが多すぎます。100 を超えることはできないことに注意してください 2. パブリック アカウントによって作成されたタグを取得します
インターフェイス呼び出しリクエストの説明
http リクエストメソッド: GET (https プロトコルを使用してください)
#https://api.weixin.qq.com/cgi-bin/tags/get?access_token=ACCESS_TOKEN 返品手順
##{ "タグ":[{ "id":1, "name":"1 日 1 缶のコーラ", "count":0 //このタグのファンの数} ,{ "id":2, "name":"スター グループ", "count":0}, { "id":127, "name":"広東", "count":5} ]} 3. タグの編集
インターフェイス呼び出しリクエストの説明
http リクエスト メソッド:POST (https プロトコルを使用してください)
https://api.weixin.qq.com/cgi-bin/tags/update?access_token=ACCESS_TOKEN
POST データ形式: JSON
POST データ例:
{
"tag" : {
"id" : 134,
"name" : "広東省人々"###### }######}###############
戻りの説明
{
"エラーコード":0,
"errmsg":"ok"
#エラー コードの説明
エラー コード 説明 -1 システムがビジーです ##45157タグ名が不正です。ご注意ください。他のタグと複製するには 名前 45158タグ名の長さが 30 バイトを超えています 45058変更できません 0 /1/2 タグはこれら 3 つのシステム用にデフォルトで予約されています 4. タグの削除
特定のタグのファン数が 100,000 を超えると、そのタグをバックグラウンドで直接削除することができないことに注意してください。現時点では、開発者はまずラベルの下の openid リストでラベルをキャンセルし、ファンの数が 100,000 を超えなくなるまでラベルを直接削除できます。
#インターフェイス呼び出しリクエストの説明
http リクエスト メソッド: POST (https プロトコルを使用してください) ) https://api.weixin.qq.com/cgi-bin/tags/delete?access_token=ACCESS_TOKENPOST データ形式: JSONPOST データの例: { "タグ":{ "id" : 134 }} 戻りの説明
##{ "errcode":0, "errmsg " :"わかりました"######}###############エラー コードの説明
エラー コード 説明 -1 システムがビジーです 45058 3 つのシステムを変更できません 0/1/ 2 タグはデフォルトで保持されます #45057このタグのファンの数は 100,000 を超えており、直接削除することはできません 5. タグ
#インターフェイス呼び出しリクエストの説明
の下にあるファンのリストを取得します。 ## http リクエスト メソッド: GET (https プロトコルを使用してください)https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token=ACCESS_TOKEN
POSTデータ形式:JSON
POSTデータ例:
{
"tagid" : 134,
"next_openid":""//最初pull OPENID を取得します。入力されていない場合は、デフォルトで最初から取得されます
}
戻り値の説明(正常時に返されるjsonパッケージの例)
{
"count ":2,//今回取得したファン数
"data":{//ファンリスト
"openid":[
"ocYxcuAEy30bX0NXmGn4ypqx3tI0",
"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"
]
},
"next_openid":"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"//リスト内の最後のユーザーの openid を取得します
}
エラー コードの説明
エラー コード 説明 -1 システムがビジーです 40003 不正な openid を受信しました 45159 不正なtag_id
ユーザー管理
ラベル機能は現在、公開アカウントでユーザーに最大 3 つのラベルを付けることをサポートしています。
1. バッチでユーザーにタグを付ける
インターフェース呼び出しリクエストの手順
http リクエストメソッド: POST (https プロトコルを使用してください)
##https://api.weixin.qq.com/cgi-bin/tags/members/batchtagging?access_token=ACCESS_TOKEN # POSTデータ形式:JSON
POSTデータ例:
{
"openid_list" : [//ファンリスト
"ocYxcuAEy30bX0NXmGn4ypqx3tI0",
"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"
],
"tagid" : 134
}
返却手順(正常時に返却されるjsonパッケージの例)
{
"errcode ":0,
"errmsg":"ok"
}
エラーコードの説明
#エラー コード 説明 #-1 システムがビジーです 40032 渡された openid リストの数毎回 50 を超えることはできません 45159 不正なタグ 45059 ファンのタグ数制限を超えました 40003 受信した不正な openid 49003 受信した openid は属していませんこのアプリへのID #2. ユーザーのタグをバッチでキャンセルする
インターフェイス呼び出しリクエストの手順
http リクエストメソッド: POST (https プロトコルを使用してください)
https://api.weixin.qq.com/cgi-bin/tags/members/batchuntagging?access_token=ACCESS_TOKEN
POSTデータ形式: JSON
POSTデータ例:
{
"openid_list" : [//ファンリスト
"ocYxcuAEy30bX0NXmGn4ypqx3tI0",
"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"
],
"tagid" : 134
}
返却手順(正常時に返却されるjsonパッケージの例)
{
"errcode ":0,
"errmsg":"ok"
}
エラーコードの説明
#エラー コード 説明 #-1 システムがビジーです 40032 渡された openid リストの数毎回 50 を超えることはできません 45159 不正なタグ 40003 不正な openid を受信しました 49003 受信した openid はこの AppID に属しません 3. ユーザーのタグ リストを取得します
インターフェイス呼び出しリクエストの説明
http リクエストメソッド: POST (https プロトコルを使用してください)
https://api.weixin.qq.com/cgi-bin/tags/getidlist?access_token=ACCESS_TOKEN
POSTデータ形式: JSON
POSTデータ例:
{
"openid" : "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"
}
戻りの説明 (通常の状況で返される json の例)
{ " tagid_list":[//設定されたタグリスト
134,
2
]
}
エラーコードの説明
#エラー コード 説明 -1 系统繁忙 40003 传入非法的openid 49003 传入的openid不属于此AppID
ユーザータグ管理
開発者は、ユーザー タグ管理の関連インターフェイスを使用して、公開アカウントのタグを作成および作成できます。ラベル付けやラベル付け解除などのクエリ、変更、削除などの操作もユーザーに対して実行できます。
#タグ管理
#公開アカウントは最大 100 個のタグを作成できます。
#インターフェイス呼び出しリクエストの説明#http リクエスト メソッド: POST (https プロトコルを使用してください)
POST データ形式: JSONPOST データの例: { "タグ" : { "名前" : "広東"//タグ名 }} パラメータの説明
|