JezK

Edit File: class-api-v3.php

<?php

/**
 * Class MC4WP_API_V3
 */
class MC4WP_API_V3
{
    /**
     * @var MC4WP_API_V3_Client
     */
    protected $client;

/**
     * Constructor
     *
     * @param string $api_key
     */
    public function __construct($api_key)
    {
        $this->client = new MC4WP_API_V3_Client($api_key);
    }

/**
     * Gets the API client to perform raw API calls.
     *
     * @return MC4WP_API_V3_Client
     */
    public function get_client()
    {
        return $this->client;
    }

/**
     * Pings the Mailchimp API to see if we're connected
     *
     * @return boolean
     * @throws MC4WP_API_Exception
     */
    public function is_connected()
    {
        $data      = $this->client->get('/', [ 'fields' => 'account_id' ]);
        $connected = is_object($data) && isset($data->account_id);
        return $connected;
    }

/**
     * @param $email_address
     *
     * @return string
     */
    public function get_subscriber_hash($email_address)
    {
        return md5(strtolower(trim($email_address)));
    }

/**
     * Get recent daily, aggregated activity stats for a list.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/activity/#read-get_lists_list_id_activity
     *
     * @param string $list_id
     * @param array $args
     *
     * @return array
     * @throws MC4WP_API_Exception
     */
    public function get_list_activity($list_id, array $args = [])
    {
        $resource = sprintf('/lists/%s/activity', $list_id);
        $data     = $this->client->get($resource, $args);

if (is_object($data) && isset($data->activity)) {
            return $data->activity;
        }

return [];
    }

/**
     * Gets the interest categories for a given List
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/interest-categories/#read-get_lists_list_id_interest_categories
     *
     * @param string $list_id
     * @param array $args
     *
     * @return array
     * @throws MC4WP_API_Exception
     */
    public function get_list_interest_categories($list_id, array $args = [])
    {
        $resource = sprintf('/lists/%s/interest-categories', $list_id);
        $data     = $this->client->get($resource, $args);

if (is_object($data) && isset($data->categories)) {
            return $data->categories;
        }

return [];
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/interest-categories/interests/#read-get_lists_list_id_interest_categories_interest_category_id_interests
     *
     * @param string $list_id
     * @param string $interest_category_id
     * @param array $args
     *
     * @return array
     * @throws MC4WP_API_Exception
     */
    public function get_list_interest_category_interests($list_id, $interest_category_id, array $args = [])
    {
        $resource = sprintf('/lists/%s/interest-categories/%s/interests', $list_id, $interest_category_id);
        $data     = $this->client->get($resource, $args);

if (is_object($data) && isset($data->interests)) {
            return $data->interests;
        }

return [];
    }

/**
     * Get merge vars for a given list
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/merge-fields/#read-get_lists_list_id_merge_fields
     *
     * @param string $list_id
     * @param array $args
     *
     * @return array
     * @throws MC4WP_API_Exception
     */
    public function get_list_merge_fields($list_id, array $args = [])
    {
        $resource = sprintf('/lists/%s/merge-fields', $list_id);
        $data     = $this->client->get($resource, $args);

if (is_object($data) && isset($data->merge_fields)) {
            return $data->merge_fields;
        }

return [];
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/#read-get_lists_list_id
     *
     * @param string $list_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_list($list_id, array $args = [])
    {
        $resource = sprintf('/lists/%s', $list_id);
        $data     = $this->client->get($resource, $args);
        return $data;
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/#read-get_lists
     *
     * @param array $args
     *
     * @return array
     * @throws MC4WP_API_Exception
     */
    public function get_lists(array $args = [])
    {
        $resource = '/lists';
        $data     = $this->client->get($resource, $args);

if (is_object($data) && isset($data->lists)) {
            return $data->lists;
        }

return [];
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/
     *
     * @param string $list_id
     * @param string $email_address
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_list_member($list_id, $email_address, array $args = [])
    {
        $subscriber_hash = $this->get_subscriber_hash($email_address);
        $resource        = sprintf('/lists/%s/members/%s', $list_id, $subscriber_hash);
        $data            = $this->client->get($resource, $args);
        return $data;
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/
     * @since 4.8.12
     * @param string $list_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_list_members($list_id, array $args = [])
    {
        $resource = sprintf('/lists/%s/members', $list_id);
        return $this->client->get($resource, $args);
    }

/**
     * Batch subscribe / unsubscribe list members.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/#create-post_lists_list_id
     *
     * @param string $list_id
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_list_members($list_id, array $args)
    {
        $resource = sprintf('/lists/%s', $list_id);
        return $this->client->post($resource, $args);
    }

/**
     * Add a new member to a Mailchimp list.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/#create-post_lists_list_id_members
     *
     * @param string $list_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_new_list_member($list_id, array $args)
    {
        $resource = sprintf('/lists/%s/members', $list_id);

// make sure we're sending an object as the Mailchimp schema requires this
        if (isset($args['merge_fields'])) {
            $args['merge_fields'] = (object) $args['merge_fields'];
        }

if (isset($args['interests'])) {
            $args['interests'] = (object) $args['interests'];
        }

if (isset($args['marketing_permissions'])) {
            $args['marketing_permissions'] = (array) $args['marketing_permissions'];
        }

return $this->client->post($resource, $args);
    }

/**
     * Add or update (!) a member to a Mailchimp list.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/#create-post_lists_list_id_members
     *
     * @param string $list_id
     * @param array $args
     * @param bool $skip_merge_validation Allow subscribing users without all required MERGE fields
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_list_member($list_id, array $args, $skip_merge_validation = false)
    {
        $subscriber_hash = $this->get_subscriber_hash($args['email_address']);
        $resource        = sprintf('/lists/%s/members/%s', $list_id, $subscriber_hash);

if ($skip_merge_validation) {
            $resource = add_query_arg([ 'skip_merge_validation' => 'true' ], $resource);
        }

// make sure we're sending an object as the Mailchimp schema requires this
        if (isset($args['merge_fields'])) {
            $args['merge_fields'] = (object) $args['merge_fields'];
        }

if (isset($args['interests'])) {
            $args['interests'] = (object) $args['interests'];
        }

if (isset($args['marketing_permissions'])) {
            $args['marketing_permissions'] = (array) $args['marketing_permissions'];
        }

// "put" updates the member if it's already on the list... take notice
        return $this->client->put($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/#edit-patch_lists_list_id_members_subscriber_hash
     *
     * @param $list_id
     * @param $email_address
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_list_member($list_id, $email_address, array $args)
    {
        $subscriber_hash = $this->get_subscriber_hash($email_address);
        $resource        = sprintf('/lists/%s/members/%s', $list_id, $subscriber_hash);

// make sure we're sending an object as the Mailchimp schema requires this
        if (isset($args['merge_fields'])) {
            $args['merge_fields'] = (object) $args['merge_fields'];
        }

if (isset($args['interests'])) {
            $args['interests'] = (object) $args['interests'];
        }

if (isset($args['marketing_permissions'])) {
            $args['marketing_permissions'] = (array) $args['marketing_permissions'];
        }

return $this->client->patch($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/
     *
     * @param string $list_id
     * @param string $email_address
     *
     * @return bool
     * @throws MC4WP_API_Exception
     */
    public function delete_list_member($list_id, $email_address)
    {
        $subscriber_hash = $this->get_subscriber_hash($email_address);
        $resource        = sprintf('/lists/%s/members/%s', $list_id, $subscriber_hash);
        $data            = $this->client->delete($resource);
        return ! ! $data;
    }

/**
     * Get the tags on a list member.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/tags/#create-post_lists_list_id_members_subscriber_hash_tags
     * @param string $list_id
     * @param string $email_address
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_list_member_tags($list_id, $email_address)
    {
        $subscriber_hash = $this->get_subscriber_hash($email_address);
        $resource        = sprintf('/lists/%s/members/%s/tags', $list_id, $subscriber_hash);
        return $this->client->get($resource);
    }

/**
     * Add or remove tags from a list member. If a tag that does not exist is passed in and set as ‘active’, a new tag will be created.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/tags/#read-get_lists_list_id_members_subscriber_hash_tags
     * @param string $list_id
     * @param string $email_address
     * @param array $data
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_list_member_tags($list_id, $email_address, array $data)
    {
        $subscriber_hash = $this->get_subscriber_hash($email_address);
        $resource        = sprintf('/lists/%s/members/%s/tags', $list_id, $subscriber_hash);
        return $this->client->post($resource, $data);
    }

/**
     * Get information about all available segments for a specific list.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/lists/segments/#read-get_lists_list_id_segments
     * @param string $list_id
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_list_segments($list_id, array $args = [])
    {
        $resource = sprintf('/lists/%s/segments', $list_id);
        return $this->client->get($resource, $args);
    }

/**
     * Get all connected sites for the Mailchimp account.
     *
     * @link https://mailchimp.com/developer/marketing/api/connected-sites/get-connected-site/
     *
     * @param array $args
     *
     * @return array
     * @throws MC4WP_API_Exception
     */
    public function get_connected_sites(array $args = [])
    {
        $data = $this->client->get('/connected-sites', $args);

if (is_object($data) && isset($data->sites)) {
            return $data->sites;
        }

return [];
    }

/**
     * Add (register) a new connected site.
     *
     * @link https://mailchimp.com/developer/marketing/api/connected-sites/add-connected-site/
     *
     * @param array $args  Must include 'foreign_id' and 'domain'.
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_connected_site(array $args)
    {
        return $this->client->post('/connected-sites', $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/#read-get_ecommerce_stores
     *
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_stores(array $args = [])
    {
        $resource = '/ecommerce/stores';
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/#read-get_ecommerce_stores_store_id
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store($store_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s', $store_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/#create-post_ecommerce_stores
     *
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_ecommerce_store(array $args)
    {
        $resource = '/ecommerce/stores';
        return $this->client->post($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/#edit-patch_ecommerce_stores_store_id
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_ecommerce_store($store_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s', $store_id);
        return $this->client->patch($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/#delete-delete_ecommerce_stores_store_id
     *
     * @param string $store_id
     *
     * @return boolean
     * @throws MC4WP_API_Exception
     */
    public function delete_ecommerce_store($store_id)
    {
        $resource = sprintf('/ecommerce/stores/%s', $store_id);
        return ! ! $this->client->delete($resource);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/customers/#read-get_ecommerce_stores_store_id_customers
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_customers($store_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/customers', $store_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/customers/#read-get_ecommerce_stores_store_id_customers_customer_id
     *
     * @param string $store_id
     * @param string $customer_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_customer($store_id, $customer_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/customers/%s', $store_id, $customer_id);
        return $this->client->get($resource, $args);
    }

/**
     * Add OR update a store customer
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/customers/#edit-put_ecommerce_stores_store_id_customers_customer_id
     *
     * @param $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_ecommerce_store_customer($store_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/customers/%s', $store_id, $args['id']);
        return $this->client->put($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/customers/#edit-patch_ecommerce_stores_store_id_customers_customer_id
     *
     * @param string $store_id
     * @param string $customer_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_ecommerce_store_customer($store_id, $customer_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/customers/%s', $store_id, $customer_id);
        return $this->client->patch($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/customers/#delete-delete_ecommerce_stores_store_id_customers_customer_id
     *
     * @param string $store_id
     * @param string $customer_id
     *
     * @return bool
     * @throws MC4WP_API_Exception
     */
    public function delete_ecommerce_store_customer($store_id, $customer_id)
    {
        $resource = sprintf('/ecommerce/stores/%s/customers/%s', $store_id, $customer_id);
        return ! ! $this->client->delete($resource);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/products/#read-get_ecommerce_stores_store_id_products
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_products($store_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/products', $store_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/products/#read-get_ecommerce_stores_store_id_products_product_id
     *
     * @param string $store_id
     * @param string $product_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_product($store_id, $product_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/products/%s', $store_id, $product_id);
        return $this->client->get($resource, $args);
    }

/**
     * Add a product to a store
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/products/#create-post_ecommerce_stores_store_id_products
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_ecommerce_store_product($store_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/products', $store_id);
        return $this->client->post($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/products/#edit-patch_ecommerce_stores_store_id_products_product_id
     *
     * @param string $store_id
     * @param string $product_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_ecommerce_store_product($store_id, $product_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/products/%s', $store_id, $product_id);
        return $this->client->patch($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/products/#delete-delete_ecommerce_stores_store_id_products_product_id
     *
     * @param string $store_id
     * @param string $product_id
     *
     * @return boolean
     * @throws MC4WP_API_Exception
     */
    public function delete_ecommerce_store_product($store_id, $product_id)
    {
        $resource = sprintf('/ecommerce/stores/%s/products/%s', $store_id, $product_id);
        return ! ! $this->client->delete($resource);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/products/variants/#read-get_ecommerce_stores_store_id_products_product_id_variants
     *
     * @param string $store_id
     * @param string $product_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_product_variants($store_id, $product_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/products/%s/variants', $store_id, $product_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/products/variants/#read-get_ecommerce_stores_store_id_products_product_id_variants_variant_id
     *
     * @param string $store_id
     * @param string $product_id
     * @param string $variant_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_product_variant($store_id, $product_id, $variant_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/products/%s/variants/%s', $store_id, $product_id, $variant_id);
        return $this->client->get($resource, $args);
    }

/**
     * Add OR update a product variant.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/products/variants/#edit-put_ecommerce_stores_store_id_products_product_id_variants_variant_id
     *
     * @param string $store_id
     * @param string $product_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_ecommerce_store_product_variant($store_id, $product_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/products/%s/variants/%s', $store_id, $product_id, $args['id']);
        return $this->client->put($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/products/variants/#edit-patch_ecommerce_stores_store_id_products_product_id_variants_variant_id
     *
     * @param string $store_id
     * @param string $product_id
     * @param string $variant_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_ecommerce_store_product_variant($store_id, $product_id, $variant_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/products/%s/variants/%s', $store_id, $product_id, $variant_id);
        return $this->client->patch($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/products/variants/#delete-delete_ecommerce_stores_store_id_products_product_id_variants_variant_id
     *
     * @param string $store_id
     * @param string $product_id
     * @param string $variant_id
     *
     * @return boolean
     * @throws MC4WP_API_Exception
     */
    public function delete_ecommerce_store_product_variant($store_id, $product_id, $variant_id)
    {
        $resource = sprintf('/ecommerce/stores/%s/products/%s/variants/%s', $store_id, $product_id, $variant_id);
        return ! ! $this->client->delete($resource);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/#read-get_ecommerce_stores_store_id_orders
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_orders($store_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/orders', $store_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/#read-get_ecommerce_stores_store_id_orders_order_id
     *
     * @param string $store_id
     * @param string $order_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_order($store_id, $order_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/orders/%s', $store_id, $order_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/#create-post_ecommerce_stores_store_id_orders
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_ecommerce_store_order($store_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/orders', $store_id);
        return $this->client->post($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/#edit-patch_ecommerce_stores_store_id_orders_order_id
     *
     * @param string $store_id
     * @param string $order_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_ecommerce_store_order($store_id, $order_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/orders/%s', $store_id, $order_id);
        return $this->client->patch($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/#delete-delete_ecommerce_stores_store_id_orders_order_id
     *
     * @param string $store_id
     * @param string $order_id
     *
     * @return bool
     * @throws MC4WP_API_Exception
     */
    public function delete_ecommerce_store_order($store_id, $order_id)
    {
        return ! ! $this->client->delete(sprintf('/ecommerce/stores/%s/orders/%s', $store_id, $order_id));
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/lines/#create-post_ecommerce_stores_store_id_orders_order_id_lines
     *
     * @param string $store_id
     * @param string $order_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_ecommerce_store_order_line($store_id, $order_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/orders/%s/lines', $store_id, $order_id);
        return $this->client->post($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/lines/#read-get_ecommerce_stores_store_id_orders_order_id_lines
     *
     * @param string $store_id
     * @param string $order_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_order_lines($store_id, $order_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/orders/%s/lines', $store_id, $order_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/lines/#read-get_ecommerce_stores_store_id_orders_order_id_lines_line_id
     *
     * @param string $store_id
     * @param string $order_id
     * @param string $line_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_order_line($store_id, $order_id, $line_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/orders/%s/lines/%s', $store_id, $order_id, $line_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/lines/#edit-patch_ecommerce_stores_store_id_orders_order_id_lines_line_id
     *
     * @param string $store_id
     * @param string $order_id
     * @param string $line_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_ecommerce_store_order_line($store_id, $order_id, $line_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/orders/%s/lines/%s', $store_id, $order_id, $line_id);
        return $this->client->patch($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/lines/#delete-delete_ecommerce_stores_store_id_orders_order_id_lines_line_id
     *
     * @param string $store_id
     * @param string $order_id
     * @param string $line_id
     *
     * @return bool
     * @throws MC4WP_API_Exception
     */
    public function delete_ecommerce_store_order_line($store_id, $order_id, $line_id)
    {
        $resource = sprintf('/ecommerce/stores/%s/orders/%s/lines/%s', $store_id, $order_id, $line_id);
        return ! ! $this->client->delete($resource);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/carts/#read-get_ecommerce_stores_store_id_carts
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_carts($store_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/carts', $store_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/carts/#read-get_ecommerce_stores_store_id_carts_cart_id
     *
     * @param string $store_id
     * @param string $cart_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_cart($store_id, $cart_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/carts/%s', $store_id, $cart_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/carts/#create-post_ecommerce_stores_store_id_carts
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_ecommerce_store_cart($store_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/carts', $store_id);
        return $this->client->post($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/carts/#edit-patch_ecommerce_stores_store_id_carts_cart_id
     *
     * @param string $store_id
     * @param string $cart_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_ecommerce_store_cart($store_id, $cart_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/carts/%s', $store_id, $cart_id);
        return $this->client->patch($resource, $args);
    }

/**
     * @link https://mailchimp.com/developer/reference/ecommerce-stores/ecommerce-carts/#delete-delete_ecommerce_stores_store_id_carts_cart_id
     *
     * @param string $store_id
     * @param string $cart_id
     *
     * @return bool
     */
    public function delete_ecommerce_store_cart($store_id, $cart_id)
    {
        return ! ! $this->client->delete(sprintf('/ecommerce/stores/%s/carts/%s', $store_id, $cart_id));
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/carts/lines/#read-get_ecommerce_stores_store_id_carts_cart_id_lines
     *
     * @param string $store_id
     * @param string $cart_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_cart_lines($store_id, $cart_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/carts/%s/lines', $store_id, $cart_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/carts/lines/#read-get_ecommerce_stores_store_id_carts_cart_id_lines_line_id
     *
     * @param string $store_id
     * @param string $cart_id
     * @param string $line_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_cart_line($store_id, $cart_id, $line_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/carts/%s/lines/%s', $store_id, $cart_id, $line_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/carts/lines/#create-post_ecommerce_stores_store_id_carts_cart_id_lines
     *
     * @param string $store_id
     * @param string $cart_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_ecommerce_store_cart_line($store_id, $cart_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/carts/%s/lines', $store_id, $cart_id);
        return $this->client->post($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/carts/lines/#edit-patch_ecommerce_stores_store_id_carts_cart_id_lines_line_id
     *
     * @param string $store_id
     * @param string $cart_id
     * @param string $line_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_ecommerce_store_cart_line($store_id, $cart_id, $line_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/carts/%s/lines/%s', $store_id, $cart_id, $line_id);
        return $this->client->patch($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/carts/lines/#delete-delete_ecommerce_stores_store_id_carts_cart_id_lines_line_id
     *
     * @param string $store_id
     * @param string $cart_id
     * @param string $line_id
     *
     * @return bool
     * @throws MC4WP_API_Exception
     */
    public function delete_ecommerce_store_cart_line($store_id, $cart_id, $line_id)
    {
        $resource = sprintf('/ecommerce/stores/%s/carts/%s/lines/%s', $store_id, $cart_id, $line_id);
        return ! ! $this->client->delete($resource);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/promo-rules/#create-post_ecommerce_stores_store_id_promo_rules
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_ecommerce_store_promo_rule($store_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/promo-rules', $store_id);
        return $this->client->post($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/promo-rules/#read-get_ecommerce_stores_store_id_promo_rules
     *
     * @param string $store_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_promo_rules($store_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/promo-rules', $store_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/promo-rules/#read-get_ecommerce_stores_store_id_promo_rules_promo_rule_id
     *
     * @param string $store_id
     * @param string $promo_rule_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_promo_rule($store_id, $promo_rule_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/promo-rules/%s', $store_id, $promo_rule_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/promo-rules/#edit-patch_ecommerce_stores_store_id_promo_rules_promo_rule_id
     *
     * @param string $store_id
     * @param string $promo_rule_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_ecommerce_store_promo_rule($store_id, $promo_rule_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/promo-rules/%s', $store_id, $promo_rule_id);
        return $this->client->patch($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/promo-rules/#delete-delete_ecommerce_stores_store_id_promo_rules_promo_rule_id
     *
     * @param string $store_id
     * @param string $promo_rule_id
     *
     * @return boolean
     * @throws MC4WP_API_Exception
     */
    public function delete_ecommerce_store_promo_rule($store_id, $promo_rule_id)
    {
        $resource = sprintf('/ecommerce/stores/%s/promo-rules/%s', $store_id, $promo_rule_id);
        return ! ! $this->client->delete($resource);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/promo-rules/promo-codes/#create-post_ecommerce_stores_store_id_promo_rules_promo_rule_id_promo_codes
     *
     * @param string $store_id
     * @param string $promo_rule_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_ecommerce_store_promo_rule_promo_code($store_id, $promo_rule_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/promo-rules/%s/promo-codes', $store_id, $promo_rule_id);
        return $this->client->post($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/promo-rules/promo-codes/#read-get_ecommerce_stores_store_id_promo_rules_promo_rule_id_promo_codes
     *
     * @param string $store_id
     * @param string $promo_rule_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_promo_rule_promo_codes($store_id, $promo_rule_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/promo-rules/%s/promo-codes', $store_id, $promo_rule_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/promo-rules/promo-codes/#read-get_ecommerce_stores_store_id_promo_rules_promo_rule_id_promo_codes_promo_code_id
     *
     * @param string $store_id
     * @param string $promo_rule_id
     * @param string $promo_code_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_ecommerce_store_promo_rule_promo_code($store_id, $promo_rule_id, $promo_code_id, array $args = [])
    {
        $resource = sprintf('/ecommerce/stores/%s/promo-rules/%s/promo-codes/%s', $store_id, $promo_rule_id, $promo_code_id);
        return $this->client->get($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/promo-rules/promo-codes/#edit-patch_ecommerce_stores_store_id_promo_rules_promo_rule_id_promo_codes_promo_code_id
     *
     * @param string $store_id
     * @param string $promo_rule_id
     * @param string $promo_code_id
     * @param array $args
     *
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_ecommerce_store_promo_rule_promo_code($store_id, $promo_rule_id, $promo_code_id, array $args)
    {
        $resource = sprintf('/ecommerce/stores/%s/promo-rules/%s/promo-codes/%s', $store_id, $promo_rule_id, $promo_code_id);
        return $this->client->patch($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/promo-rules/promo-codes/#delete-delete_ecommerce_stores_store_id_promo_rules_promo_rule_id_promo_codes_promo_code_id
     *
     * @param string $store_id
     * @param string $promo_rule_id
     * @param string $promo_code_id
     *
     * @return boolean
     * @throws MC4WP_API_Exception
     */
    public function delete_ecommerce_store_promo_rule_promo_code($store_id, $promo_rule_id, $promo_code_id)
    {
        $resource = sprintf('/ecommerce/stores/%s/promo-rules/%s/promo-codes/%s', $store_id, $promo_rule_id, $promo_code_id);
        return ! ! $this->client->delete($resource);
    }

/**
     * Get a list of an account's available templates
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/templates/#read-get_templates
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_templates(array $args = [])
    {
        $resource = '/templates';
        return $this->client->get($resource, $args);
    }

/**
     * Get information about a specific template.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/templates/#read-get_templates_template_id
     * @param string $template_id
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_template($template_id, array $args = [])
    {
        $resource = sprintf('/templates/%s', $template_id);
        return $this->client->get($resource, $args);
    }

/**
     * Create a new template.
     *
     * @link https://mailchimp.com/developer/reference/templates/#post_/templates
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_template(array $args)
    {
        $resource = '/templates';
        return $this->client->post($resource, $args);
    }

/**
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/templates/default-content/
     * @param string $template_id
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_template_default_content($template_id, array $args = [])
    {
        $resource = sprintf('/templates/%s/default-content', $template_id);
        return $this->client->get($resource, $args);
    }

/**
     * Create a new campaign
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/campaigns/#create-post_campaigns
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function add_campaign(array $args)
    {
        $resource = '/campaigns';
        return $this->client->post($resource, $args);
    }

/**
     * Get all campaigns in an account
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/campaigns/#read-get_campaigns
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_campaigns(array $args = [])
    {
        $resource = '/campaigns';
        return $this->client->get($resource, $args);
    }

/**
     * Get information about a specific campaign.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/campaigns/#read-get_campaigns_campaign_id
     * @param string $campaign_id
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_campaign($campaign_id, array $args = [])
    {
        $resource = sprintf('/campaigns/%s', $campaign_id);
        return $this->client->get($resource, $args);
    }

/**
     * Update some or all of the settings for a specific campaign.
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/campaigns/#edit-patch_campaigns_campaign_id
     * @param string $campaign_id
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_campaign($campaign_id, array $args)
    {
        $resource = sprintf('/campaigns/%s', $campaign_id);
        return $this->client->patch($resource, $args);
    }

/**
     * Remove a campaign from the Mailchimp account
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/campaigns/#delete-delete_campaigns_campaign_id
     * @param string $campaign_id
     * @return bool
     * @throws MC4WP_API_Exception
     */
    public function delete_campaign($campaign_id)
    {
        $resource = sprintf('/campaigns/%s', $campaign_id);
        return ! ! $this->client->delete($resource);
    }

/**
     * Perform an action on a Mailchimp campaign
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/campaigns/#action-post_campaigns
     *
     * @param string $campaign_id
     * @param string $action
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function campaign_action($campaign_id, $action, array $args = [])
    {
        $resource = sprintf('/campaigns/%s/actions/%s', $campaign_id, $action);
        return $this->client->post($resource, $args);
    }

/**
     * Get the HTML and plain-text content for a campaign
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/campaigns/content/#read-get_campaigns_campaign_id_content
     * @param string $campaign_id
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function get_campaign_content($campaign_id, array $args = [])
    {
        $resource = sprintf('/campaigns/%s/content', $campaign_id);
        return $this->client->get($resource, $args);
    }

/**
     * Set the content for a campaign
     *
     * @link https://developer.mailchimp.com/documentation/mailchimp/reference/campaigns/content/#edit-put_campaigns_campaign_id_content
     * @param string $campaign_id
     * @param array $args
     * @return object
     * @throws MC4WP_API_Exception
     */
    public function update_campaign_content($campaign_id, array $args)
    {
        $resource = sprintf('/campaigns/%s/content', $campaign_id);
        return $this->client->put($resource, $args);
    }

/**
     * @return string
     */
    public function get_last_response_body()
    {
        return $this->client->get_last_response_body();
    }

/**
     * @return array
     */
    public function get_last_response_headers()
    {
        return $this->client->get_last_response_headers();
    }
}