o ˷e0@sdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZGdddeZdS)z The Lists API endpoint Documentation: http://developer.mailchimp.com/documentation/mailchimp/reference/lists/ Schema: https://api.mailchimp.com/schema/3.0/Lists/Instance.json )unicode_literals)BaseApi)ListAbuseReports) ListActivity) ListClients)ListGrowthHistory)ListInterestCategories) ListMembers)ListMergeFields) ListSegments)ListSignupForms) ListWebhooks) check_emailcsReZdZdZfddZddZddZdd d Zd d Zd dZ ddZ Z S)Listsz_ A MailChimp list is a powerful and flexible tool that helps you manage your contacts. cstt|j|i|d|_d|_t||_t||_t ||_ t ||_ t ||_t||_t||_t||_t||_t||_dS)z) Initialize the endpoint listsN)superr__init__endpointlist_idr abuse_reportsractivityrclientsrgrowth_historyrinterest_categoriesr membersr merge_fieldsr segmentsr signup_formsr webhooks)selfargskwargs __class__P/var/www/ideatree/venv/lib/python3.10/site-packages/mailchimp3/entities/lists.pyrs         zLists.__init__cCspd|vrtdd|vrtdd|dvrtdd|dvr$tdd |dvr.td d |dvr8td d |dvrBtdd|dvrLtdd|vrTtdd|vr\tdd|dvrftdd|dvrptdt|ddd|dvrtdd|dvrtdd|vrtd|ddvrtd |jj||d!}|d"ur|d#|_|Sd"|_|S)$a Create a new list in your MailChimp account. :param data: The request body parameters :type data: :py:class:`dict` data = { "name": string*, "contact": object* { "company": string*, "address1": string*, "city": string*, "state": string*, "zip": string*, "country": string* }, "permission_reminder": string*, "campaign_defaults": object* { "from_name": string*, "from_email": string*, "subject": string*, "language": string* }, "email_type_option": boolean } nameThe list must have a namecontactThe list must have a contactcompany$The list contact must have a companyaddress1%The list contact must have a address1city!The list contact must have a citystate"The list contact must have a statezip The list contact must have a zipcountry$The list contact must have a countrypermission_reminder(The list must have a permission_remindercampaign_defaults&The list must have a campaign_defaults from_name0The list campaign_defaults must have a from_name from_email1The list campaign_defaults must have a from_emailsubject.The list campaign_defaults must have a subjectlanguage/The list campaign_defaults must have a languageemail_type_option'The list must have an email_type_optionTF0The list email_type_option must be True or FalseurldataNid)KeyErrorr TypeError _mc_client_post _build_pathr)rrHresponser$r$r%create/sN            z Lists.createcCs||_d|vr tdt|ddkstd|dD]<}d|vr%tdt|dd|vr7d|vr7td gd }d|vrI|d|vrItd d|vrW|d|vrWtd qd |vr`d|d <|jj|||dS)a Batch subscribe or unsubscribe list members. Only the members array is required in the request body parameters. Within the members array, each member requires an email_address and either a status or status_if_new. The update_existing parameter will also be considered required to help prevent accidental updates to existing members and will default to false if not present. :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 = { "members": array* [ { "email_address": string*, "status": string* (Must be one of 'subscribed', 'unsubscribed', 'cleaned', or 'pending'), "status_if_new": string* (Must be one of 'subscribed', 'unsubscribed', 'cleaned', or 'pending') } ], "update_existing": boolean* } rz(The update must have at least one memberiz2You may only batch sub/unsub 500 members at a time email_addressz+Each list member must have an email_addressstatus status_if_newz=Each list member must have either a status or a status_if_new) subscribed unsubscribedcleanedpendingz[The list member status must be one of "subscribed", "unsubscribed", "cleaned", or "pending"zbThe list member status_if_new must be one of "subscribed", "unsubscribed", "cleaned", or "pending"update_existingFrF)rrJlen ValueErrorrrLrMrN)rrrHmembervalid_statusesr$r$r%update_membersts(  zLists.update_membersFcKs<d|_|r|jdd|i|S|jjdd|i|S)a Get information about all lists in the account. :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['before_date_created'] = string queryparams['since_date_created'] = string queryparams['before_campaign_last_sent'] = string queryparams['since_campaign_last_sent'] = string queryparams['email'] = string queryparams['sort_field'] = string (Must be 'date_created') queryparams['sort_dir'] = string (Must be one of 'ASC' or 'DESC') NrGr$)r_iteraterNrL_get)rget_all queryparamsr$r$r%allsz Lists.allcKs"||_|jjdd||i|S)u Get information about a specific list in your MailChimp account. Results include list members who have signed up but haven’t confirmed their subscription yet and unsubscribed or cleaned. :param list_id: The unique id for the list. :type list_id: :py:class:`str` :param queryparams: The query string parameters queryparams['fields'] = [] queryparams['exclude_fields'] = [] rGNr$)rrLr_rN)rrrar$r$r%gets z Lists.getcCsX||_d|vr tdd|vrtdd|dvrtdd|dvr'tdd |dvr1td d |dvr;td d |dvrEtdd|dvrOtdd|vrWtdd|vr_tdd|dvritdd|dvrstdt|ddd|dvrtdd|dvrtdd|vrtd|ddvrtd |jj|||d!S)"a_ Update the settings for a specific 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 = { "name": string*, "contact": object* { "company": string*, "address1": string*, "city": string*, "state": string*, "zip": string*, "country": string* }, "permission_reminder": string*, "campaign_defaults": object* { "from_name": string*, "from_email": string*, "subject": string*, "language": string* }, "email_type_option": boolean } r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErF)rrJrrKrL_patchrN)rrrHr$r$r%updatesF           z Lists.updatecCs||_|jj||dS)u Delete a list from your MailChimp account. If you delete a list, you’ll lose the list history—including subscriber activity, unsubscribes, complaints, and bounces. You’ll also lose subscribers’ email addresses, unless you exported and backed up your list. :param list_id: The unique id for the list. :type list_id: :py:class:`str` )rG)rrL_deleterN)rrr$r$r%deletes z Lists.delete)F) __name__ __module__ __qualname____doc__rrPr]rbrcrerg __classcell__r$r$r"r%rs E 2CrN)rk __future__rmailchimp3.baseapir$mailchimp3.entities.listabusereportsr mailchimp3.entities.listactivityrmailchimp3.entities.listclientsr%mailchimp3.entities.listgrowthhistoryr*mailchimp3.entities.listinterestcategoriesrmailchimp3.entities.listmembersr #mailchimp3.entities.listmergefieldsr mailchimp3.entities.listsegmentsr #mailchimp3.entities.listsignupformsr mailchimp3.entities.listwebhooksr mailchimp3.helpersrrr$r$r$r%s