wingmonkey 0.1.21

[](https://coveralls.io/github/vikingco/wingmonkey?branch=master )
[](https://travis-ci.org/vikingco/wingmonkey)

#wingmonkey
mailchimp api v3 客户端

mailchimp v3 api 参考文档：http://developer.mailchimp.com/documentation/mailchimp/reference/overview/


### 设置

为了能够调用 mailchimp 而无需自己初始化自定义 MailChimpSession，请确保至少遵循设置环境变量（或添加到 .env 文件）：

```python
DEFAULT_MAILCHIMP_API_KEY=<YOUR MAILCHIMP API KEY>


```

对于更高级的用法，您可以将自定义

MailChimpSession传递给序列化程序和函数：KEY>) list_serializer = ListSerializer(session=session) ``` ### 更多使用示例：####getting list info ```python fromwingmonkey.lists import ListSerializer list_serializer = ListSerializer() list_id = 'A_VALID_LIST_ID' my_list = list_serializer.read(list_id=list_id) name = my_list.name total_subscribers = my_list.stats['member_count']






















unsubscribe_count = my_list.stats['unsubscribe_count']
```
#### 创建新成员

```python
fromwingmonkey.members import Member, MemberSerializer

email_address = 'monkeysee@monkey.do'
merge_fields = {FNAME: 'Ceasar', LNAME: 'Chimp'}
语言 = 'en'
list_id = 'A_VALID_LIST_ID'

member_to_add = Member(
email_address=email_address,
merge_fields=merge_fields,
language=language,
list_id=list_id
)

member_serializer = MemberSerializer()

new_added_member = member_serializer.create(list_id=list_id ,实例=member_to_add)
```

#### 获取列表的所有成员

```python

fromwingmonkey.async_operations import get_all_members_async
from datetime import datetime, timedelta

list_id = 'A_VALID_LIST_ID'
```

* 所有成员
```python
all_list_members = get_all_members_async(list_id= list_id)
```

* 自特定日期以来更新的所有成员（注意使用正确的日期时间字符串格式）
```python
date_since = datetime.strftime(datetime.now() - timedelta(days=1), '%Y -%m-%dT%H:%M:%S')
extra_params = {'since_last_changed': date_since }
all_updated_members_since_yesterday = get_all_members_async(list_id=list_id, extra_params=extra_params)
```

#### 批量更新大量成员
* 这将返回一个对应批量操作资源的列表（每500个成员1个）
http://developer.mailchimp.com/documentation/mailchimp/reference/batches/#create -post_batches
http://developer.mailchimp.com/documentation/mailchimp/reference/lists/#create-post_lists_list_id

```python
fromwingmonkey.async_operations import batch_update_members_async
list_id = 'A_VALID_LIST_ID'
member_list = [A_LIST_OF_MEMBER_INSTANCES]

batch_operation_resource_list = batch_update_members_async(list_id= list_id, member_list=member_list)
```