o ˷e. @spdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZGd d d eZd S) z The List Members API endpoint Documentation: http://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/ Schema: https://api.mailchimp.com/schema/3.0/Lists/Members/Instance.json )unicode_literals)BaseApi)ListMemberActivity)ListMemberEvents)ListMemberGoals)ListMemberNotes) check_emailcheck_subscriber_hashcsZeZdZdZfddZddZdddZd d Zd d Zd dZ ddZ ddZ Z S) ListMembersz} Manage members of a specific MailChimp list, including currently subscribed, unsubscribed, and bounced members. csTtt|j|i|d|_d|_d|_t||_t||_ t ||_ t ||_ dS)z) Initialize the endpoint listsN)superr __init__endpointlist_idsubscriber_hashractivityreventsrgoalsrnotes)selfargskwargs __class__V/var/www/ideatree/venv/lib/python3.10/site-packages/mailchimp3/entities/listmembers.pyr s   zListMembers.__init__cCs~||_d|vr td|ddvrtdd|vrtdt|d|jj||d|d}|d ur:|d |_|Sd |_|S) a Add a new member to the list. :param list_id: The unique id for the list. :type list_id: :py:class:`str` :param data: The request body parameters :type data: :py:class:`dict` data = { "status": string*, (Must be one of 'subscribed', 'unsubscribed', 'cleaned', 'pending', or 'transactional') "email_address": string* } statusz"The list member must have a status subscribed unsubscribedcleanedpending transactionalzlThe list member status must be one of "subscribed", "unsubscribed", "cleaned", "pending", or "transactional" email_address*The list member must have an email_addressmembersurldataNid)rKeyError ValueErrorr _mc_client_post _build_pathr)rrr(responserrrcreate%s   zListMembers.createFcKsJ||_d|_|r|jdd||di|S|jjdd||di|S)a Get information about members in a specific MailChimp list. :param list_id: The unique id for the list. :type list_id: :py:class:`str` :param get_all: Should the query get all results :type get_all: :py:class:`bool` :param queryparams: The query string parameters queryparams['fields'] = [] queryparams['exclude_fields'] = [] queryparams['count'] = integer queryparams['offset'] = integer queryparams['email_type'] = string queryparams['status'] = string queryparams['before_timestamp_opt'] = string queryparams['since_timestamp_opt'] = string queryparams['before_last_changed'] = string queryparams['since_last_changed'] = string queryparams['unique_email_id'] = string queryparams['vip_only'] = boolean queryparams['interest_category_id'] = string queryparams['interest_ids'] = string queryparams['interest_match'] = string Nr'r%r)rr_iterater.r,_get)rrget_all queryparamsrrrallDs zListMembers.allcKs4t|}||_||_|jjdd||d|i|S)u Get information about a specific list member, including a currently subscribed, unsubscribed, or bounced member. :param list_id: The unique id for the list. :type list_id: :py:class:`str` :param subscriber_hash: The MD5 hash of the lowercase version of the list member’s email address. :type subscriber_hash: :py:class:`str` :param queryparams: The query string parameters queryparams['fields'] = [] queryparams['exclude_fields'] = [] r'r%Nr)r rrr,r2r.)rrrr4rrrgetes zListMembers.getcCs.t|}||_||_|jj||d||dS)u Update information for a specific list member. :param list_id: The unique id for the list. :type list_id: :py:class:`str` :param subscriber_hash: The MD5 hash of the lowercase version of the list member’s email address. :type subscriber_hash: :py:class:`str` :param data: The request body parameters :type data: :py:class:`dict` r%r&)r rrr,_patchr.rrrr(rrrupdateys zListMembers.updatecCsnt|}||_||_d|vrtdt|dd|vr td|ddvr*td|jj||d||dS) uU Add or update a list member. :param list_id: The unique id for the list. :type list_id: :py:class:`str` :param subscriber_hash: The MD5 hash of the lowercase version of the list member’s email address. :type subscriber_hash: :py:class:`str` :param data: The request body parameters :type data: :py:class:`dict` data = { "email_address": string*, "status_if_new": string* (Must be one of 'subscribed', 'unsubscribed', 'cleaned', 'pending', or 'transactional') } r#r$ status_if_newz)The list member must have a status_if_newrzsThe list member status_if_new must be one of "subscribed", "unsubscribed", "cleaned", "pending", or "transactional"r%r&) r rrr*rr+r,_putr.r8rrrcreate_or_updates  zListMembers.create_or_updatecCs,t|}||_||_|jj||d|dS)u/ Delete a member from a list. :param list_id: The unique id for the list. :type list_id: :py:class:`str` :param subscriber_hash: The MD5 hash of the lowercase version of the list member’s email address. :type subscriber_hash: :py:class:`str` r%r')r rrr,_deleter.rrrrrrdeletes zListMembers.deletecCs0t|}||_||_|jj||d|dddS)u; Delete permanently a member from a list. :param list_id: The unique id for the list. :type list_id: :py:class:`str` :param subscriber_hash: The MD5 hash of the lowercase version of the list member’s email address. :type subscriber_hash: :py:class:`str` r%actionszdelete-permanentr=)r rrr,r-r.r?rrrdelete_permanents zListMembers.delete_permanent)F) __name__ __module__ __qualname____doc__r r0r5r6r9r<r@rB __classcell__rrrrr s  !r N)rF __future__rmailchimp3.baseapir&mailchimp3.entities.listmemberactivityr$mailchimp3.entities.listmembereventsr#mailchimp3.entities.listmembergoalsr#mailchimp3.entities.listmembernotesrmailchimp3.helpersrr r rrrrs