Na}{

File Content: `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( '/', array( '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 = array() ) {
		$resource = sprintf( '/lists/%s/activity', $list_id );
		$data     = $this->client->get( $resource, $args );

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

		return array();
	}

	/**
	 * 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 = array() ) {
		$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 array();
	}

	/**
	 * @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 = array() ) {
		$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 array();
	}

	/**
	 * 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 = array() ) {
		$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 array();
	}

	/**
	 * @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 = array() ) {
		$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 = array() ) {
		$resource = '/lists';
		$data     = $this->client->get( $resource, $args );

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

		return array();
	}

	/**
	 * @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 = array() ) {
		$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 = array() ) {
		$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( array( '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 = array() ) {
		$resource = sprintf( '/lists/%s/segments', $list_id );
		return $this->client->get( $resource, $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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$resource = sprintf( '/ecommerce/stores/%s/carts/%/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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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 = array() ) {
		$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();
	}
}
Name	Size	Permission
class-api-v3-client.php	5708 bytes	0644
class-api-v3.php	43329 bytes	0644
class-connection-exception.php	77 bytes	0644
class-exception.php	3216 bytes	0644
class-resource-not-found-exception.php	150 bytes	0644
File Content: class-api-v3.php

File Content: `class-api-v3.php`
