ユーザータグ管理


ユーザータグ管理

1474939241277079.jpg

開発者は、ユーザー タグ管理の関連インターフェイスを使用して、公開アカウントのタグを作成および作成できます。ラベル付けやラベル付け解除などのクエリ、変更、削除などの操作もユーザーに対して実行できます。

#タグ管理

##1. タグの作成

#公開アカウントは最大 100 個のタグを作成できます。

#インターフェイス呼び出しリクエストの説明

#http リクエスト メソッド: POST (https プロトコルを使用してください)https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKEN
POST データ形式: JSON

POST データの例:

{

"タグ" : {

"名前" : "広東"//タグ名

}

}

パラメータの説明

access_token呼び出しインターフェース認証情報nameタグ名 (30 文字以内)

戻り値の説明(正常時に返されるjsonデータパケットの例)

パラメータ説明
##{

戻りパラメータの説明

"tag":{

"id":134,//タグid

"name":"広東"

}

}

#idWeChat によって割り当てられたタグ ID nameタグ名、UTF8 エンコーディング#

エラー コードの説明

パラメータ説明
-1システムがビジーです##451574515845056

2. パブリック アカウントによって作成されたタグを取得します

インターフェイス呼び出しリクエストの説明

エラー コード説明
タグ名が不正です。ご注意ください。他のタグと複製するには 名前
タグ名の長さが 30 バイトを超えています
作成されたタグが多すぎます。100 を超えることはできないことに注意してください

返品手順

http リクエストメソッド: GET (https プロトコルを使用してください)

#https://api.weixin.qq.com/cgi-bin/tags/get?access_token=ACCESS_TOKEN

3. タグの編集

インターフェイス呼び出しリクエストの説明

##{

"タグ":[{

"id":1,

"name":"1 日 1 缶のコーラ",

"count":0 //このタグのファンの数

} ,{

"id":2,

"name":"スター グループ",

"count":0

}, {

"id":127,

"name":"広東",

"count":5

}

]

}

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システムがビジーです##451574515845058

4. タグの削除

特定のタグのファン数が 100,000 を超えると、そのタグをバックグラウンドで直接削除することができないことに注意してください。現時点では、開発者はまずラベルの下の openid リストでラベルをキャンセルし、ファンの数が 100,000 を超えなくなるまでラベルを直接削除できます。

#インターフェイス呼び出しリクエストの説明

エラー コード説明
タグ名が不正です。ご注意ください。他のタグと複製するには 名前
タグ名の長さが 30 バイトを超えています
変更できません 0 /1/2 タグはこれら 3 つのシステム用にデフォルトで予約されています
http リクエスト メソッド: POST (https プロトコルを使用してください) )

戻りの説明

https://api.weixin.qq.com/cgi-bin/tags/delete?access_token=ACCESS_TOKEN

POST データ形式: JSON

POST データの例:

{

"タグ":{

"id" : 134

}

}

##{

"errcode":0,

"errmsg " :"わかりました"######}###############

エラー コードの説明

-1システムがビジーです450583 つのシステムを変更できません 0/1/ 2 タグはデフォルトで保持されます #45057

5. タグ

#インターフェイス呼び出しリクエストの説明

エラー コード説明
このタグのファンの数は 100,000 を超えており、直接削除することはできません
の下にあるファンのリストを取得します。 ## http リクエスト メソッド: GET (https プロトコルを使用してください)

戻り値の説明(正常時に返されるjsonパッケージの例)

https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token=ACCESS_TOKEN

POSTデータ形式:JSON

POSTデータ例:

{

"tagid" : 134,

"next_openid":""//最初pull OPENID を取得します。入力されていない場合は、デフォルトで最初から取得されます

}

{

"count ":2,//今回取得したファン数

"data":{//ファンリスト

"openid":[

"ocYxcuAEy30bX0NXmGn4ypqx3tI0",

"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"

]

},

"next_openid":"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"//リスト内の最後のユーザーの openid を取得します

}

エラー コードの説明

-1システムがビジーです40003不正な openid を受信しました45159不正なtag_id


ユーザー管理

ラベル機能は現在、公開アカウントでユーザーに最大 3 つのラベルを付けることをサポートしています。

1. バッチでユーザーにタグを付ける

インターフェース呼び出しリクエストの手順

エラー コード説明

返却手順(正常時に返却されるjsonパッケージの例)

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

}

{

"errcode ":0,

"errmsg":"ok"

}

エラーコードの説明

#-1システムがビジーです40032渡された openid リストの数毎回 50 を超えることはできません45159不正なタグ45059ファンのタグ数制限を超えました40003受信した不正な openid49003受信した 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