class-Mandrill_Exports.html 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5. <meta name="generator" content="ApiGen 2.8.0" />
  6. <title>Class Mandrill_Exports</title>
  7. <script type="text/javascript" src="resources/combined.js?394153670"></script>
  8. <script type="text/javascript" src="elementlist.js?882160656"></script>
  9. <link rel="stylesheet" type="text/css" media="all" href="resources/style.css?3505392360" />
  10. </head>
  11. <body>
  12. <div id="left">
  13. <div id="menu">
  14. <a href="index.html" title="Overview"><span>Overview</span></a>
  15. <div id="groups">
  16. <h3>Namespaces</h3>
  17. <ul>
  18. <li class="active"><a href="namespace-None.html">None</a>
  19. </li>
  20. <li><a href="namespace-PHP.html">PHP</a>
  21. </li>
  22. </ul>
  23. </div>
  24. <hr />
  25. <div id="elements">
  26. <h3>Classes</h3>
  27. <ul>
  28. <li><a href="class-Mandrill.html">Mandrill</a></li>
  29. <li class="active"><a href="class-Mandrill_Exports.html">Mandrill_Exports</a></li>
  30. <li><a href="class-Mandrill_Inbound.html">Mandrill_Inbound</a></li>
  31. <li><a href="class-Mandrill_Internal.html">Mandrill_Internal</a></li>
  32. <li><a href="class-Mandrill_Ips.html">Mandrill_Ips</a></li>
  33. <li><a href="class-Mandrill_Messages.html">Mandrill_Messages</a></li>
  34. <li><a href="class-Mandrill_Metadata.html">Mandrill_Metadata</a></li>
  35. <li><a href="class-Mandrill_Rejects.html">Mandrill_Rejects</a></li>
  36. <li><a href="class-Mandrill_Senders.html">Mandrill_Senders</a></li>
  37. <li><a href="class-Mandrill_Subaccounts.html">Mandrill_Subaccounts</a></li>
  38. <li><a href="class-Mandrill_Tags.html">Mandrill_Tags</a></li>
  39. <li><a href="class-Mandrill_Templates.html">Mandrill_Templates</a></li>
  40. <li><a href="class-Mandrill_Urls.html">Mandrill_Urls</a></li>
  41. <li><a href="class-Mandrill_Users.html">Mandrill_Users</a></li>
  42. <li><a href="class-Mandrill_Webhooks.html">Mandrill_Webhooks</a></li>
  43. <li><a href="class-Mandrill_Whitelists.html">Mandrill_Whitelists</a></li>
  44. </ul>
  45. <h3>Exceptions</h3>
  46. <ul>
  47. <li><a href="class-Mandrill_Error.html">Mandrill_Error</a></li>
  48. <li><a href="class-Mandrill_HttpError.html">Mandrill_HttpError</a></li>
  49. <li><a href="class-Mandrill_Invalid_CustomDNS.html">Mandrill_Invalid_CustomDNS</a></li>
  50. <li><a href="class-Mandrill_Invalid_CustomDNSPending.html">Mandrill_Invalid_CustomDNSPending</a></li>
  51. <li><a href="class-Mandrill_Invalid_DeleteDefaultPool.html">Mandrill_Invalid_DeleteDefaultPool</a></li>
  52. <li><a href="class-Mandrill_Invalid_DeleteNonEmptyPool.html">Mandrill_Invalid_DeleteNonEmptyPool</a></li>
  53. <li><a href="class-Mandrill_Invalid_EmptyDefaultPool.html">Mandrill_Invalid_EmptyDefaultPool</a></li>
  54. <li><a href="class-Mandrill_Invalid_Key.html">Mandrill_Invalid_Key</a></li>
  55. <li><a href="class-Mandrill_Invalid_Reject.html">Mandrill_Invalid_Reject</a></li>
  56. <li><a href="class-Mandrill_Invalid_Tag_Name.html">Mandrill_Invalid_Tag_Name</a></li>
  57. <li><a href="class-Mandrill_Invalid_Template.html">Mandrill_Invalid_Template</a></li>
  58. <li><a href="class-Mandrill_IP_ProvisionLimit.html">Mandrill_IP_ProvisionLimit</a></li>
  59. <li><a href="class-Mandrill_Metadata_FieldLimit.html">Mandrill_Metadata_FieldLimit</a></li>
  60. <li><a href="class-Mandrill_NoSendingHistory.html">Mandrill_NoSendingHistory</a></li>
  61. <li><a href="class-Mandrill_PaymentRequired.html">Mandrill_PaymentRequired</a></li>
  62. <li><a href="class-Mandrill_PoorReputation.html">Mandrill_PoorReputation</a></li>
  63. <li><a href="class-Mandrill_ServiceUnavailable.html">Mandrill_ServiceUnavailable</a></li>
  64. <li><a href="class-Mandrill_Unknown_Export.html">Mandrill_Unknown_Export</a></li>
  65. <li><a href="class-Mandrill_Unknown_InboundDomain.html">Mandrill_Unknown_InboundDomain</a></li>
  66. <li><a href="class-Mandrill_Unknown_InboundRoute.html">Mandrill_Unknown_InboundRoute</a></li>
  67. <li><a href="class-Mandrill_Unknown_IP.html">Mandrill_Unknown_IP</a></li>
  68. <li><a href="class-Mandrill_Unknown_Message.html">Mandrill_Unknown_Message</a></li>
  69. <li><a href="class-Mandrill_Unknown_MetadataField.html">Mandrill_Unknown_MetadataField</a></li>
  70. <li><a href="class-Mandrill_Unknown_Pool.html">Mandrill_Unknown_Pool</a></li>
  71. <li><a href="class-Mandrill_Unknown_Sender.html">Mandrill_Unknown_Sender</a></li>
  72. <li><a href="class-Mandrill_Unknown_Subaccount.html">Mandrill_Unknown_Subaccount</a></li>
  73. <li><a href="class-Mandrill_Unknown_Template.html">Mandrill_Unknown_Template</a></li>
  74. <li><a href="class-Mandrill_Unknown_TrackingDomain.html">Mandrill_Unknown_TrackingDomain</a></li>
  75. <li><a href="class-Mandrill_Unknown_Url.html">Mandrill_Unknown_Url</a></li>
  76. <li><a href="class-Mandrill_Unknown_Webhook.html">Mandrill_Unknown_Webhook</a></li>
  77. <li><a href="class-Mandrill_ValidationError.html">Mandrill_ValidationError</a></li>
  78. </ul>
  79. </div>
  80. </div>
  81. </div>
  82. <div id="splitter"></div>
  83. <div id="right">
  84. <div id="rightInner">
  85. <form id="search">
  86. <input type="hidden" name="cx" value="" />
  87. <input type="hidden" name="ie" value="UTF-8" />
  88. <input type="text" name="q" class="text" />
  89. <input type="submit" value="Search" />
  90. </form>
  91. <div id="navigation">
  92. <ul>
  93. <li>
  94. <a href="index.html" title="Overview"><span>Overview</span></a>
  95. </li>
  96. <li>
  97. <a href="namespace-None.html" title="Summary of None"><span>Namespace</span></a>
  98. </li>
  99. <li class="active">
  100. <span>Class</span> </li>
  101. </ul>
  102. <ul>
  103. <li>
  104. <a href="tree.html" title="Tree view of classes, interfaces, traits and exceptions"><span>Tree</span></a>
  105. </li>
  106. </ul>
  107. <ul>
  108. </ul>
  109. </div>
  110. <div id="content" class="class">
  111. <h1>Class Mandrill_Exports</h1>
  112. <div class="info">
  113. <b>Located at</b> <a href="source-class-Mandrill_Exports.html#3-110" title="Go to source code">Mandrill/Exports.php</a><br />
  114. </div>
  115. <table class="summary" id="methods">
  116. <caption>Methods summary</caption>
  117. <tr data-order="__construct" id="___construct">
  118. <td class="attributes"><code>
  119. public
  120. </code>
  121. </td>
  122. <td class="name"><div>
  123. <a class="anchor" href="#___construct">#</a>
  124. <code><a href="source-class-Mandrill_Exports.html#4-6" title="Go to source code">__construct</a>( <span><code><a href="class-Mandrill.html">Mandrill</a></code> <var>$master</var></span> )</code>
  125. <div class="description short">
  126. </div>
  127. <div class="description detailed hidden">
  128. </div>
  129. </div></td>
  130. </tr>
  131. <tr data-order="info" id="_info">
  132. <td class="attributes"><code>
  133. public
  134. struct
  135. </code>
  136. </td>
  137. <td class="name"><div>
  138. <a class="anchor" href="#_info">#</a>
  139. <code><a href="source-class-Mandrill_Exports.html#8-26" title="Go to source code">info</a>( <span>string <var>$id</var></span> )</code>
  140. <div class="description short">
  141. <p>Returns information about an export job. If the export job's state is
  142. 'complete', the returned data will include a URL you can use to fetch the
  143. results. Every export job produces a zip archive, but the format of the archive
  144. is distinct for each job type. The api calls that initiate exports include more
  145. details about the output format for that job type.</p>
  146. </div>
  147. <div class="description detailed hidden">
  148. <p>Returns information about an export job. If the export job's state is
  149. 'complete', the returned data will include a URL you can use to fetch the
  150. results. Every export job produces a zip archive, but the format of the archive
  151. is distinct for each job type. The api calls that initiate exports include more
  152. details about the output format for that job type.</p>
  153. <h4>Parameters</h4>
  154. <div class="list"><dl>
  155. <dt><var>$id</var></dt>
  156. <dd><code>string</code><br>$id an export job identifier</dd>
  157. </dl></div>
  158. <h4>Returns</h4>
  159. <div class="list">
  160. <code>struct</code><br>the information about the export - id string the unique identifier for this
  161. Export. Use this identifier when checking the export job's status - created_at
  162. string the date and time that the export job was created as a UTC string in
  163. YYYY-MM-DD HH:MM:SS format - type string the type of the export job - activity,
  164. reject, or whitelist - finished_at string the date and time that the export job
  165. was finished as a UTC string in YYYY-MM-DD HH:MM:SS format - state string the
  166. export job's state - waiting, working, complete, error, or expired. - result_url
  167. string the url for the export job's results, if the job is completed.<br />
  168. </div>
  169. </div>
  170. </div></td>
  171. </tr>
  172. <tr data-order="getList" id="_getList">
  173. <td class="attributes"><code>
  174. public
  175. array
  176. </code>
  177. </td>
  178. <td class="name"><div>
  179. <a class="anchor" href="#_getList">#</a>
  180. <code><a href="source-class-Mandrill_Exports.html#28-42" title="Go to source code">getList</a>( )</code>
  181. <div class="description short">
  182. <p>Returns a list of your exports.</p>
  183. </div>
  184. <div class="description detailed hidden">
  185. <p>Returns a list of your exports.</p>
  186. <h4>Returns</h4>
  187. <div class="list">
  188. <code>array</code><br>the account's exports - return[] struct the individual export info - id string
  189. the unique identifier for this Export. Use this identifier when checking the
  190. export job's status - created_at string the date and time that the export job
  191. was created as a UTC string in YYYY-MM-DD HH:MM:SS format - type string the type
  192. of the export job - activity, reject, or whitelist - finished_at string the date
  193. and time that the export job was finished as a UTC string in YYYY-MM-DD HH:MM:SS
  194. format - state string the export job's state - waiting, working, complete,
  195. error, or expired. - result_url string the url for the export job's results, if
  196. the job is completed.<br />
  197. </div>
  198. </div>
  199. </div></td>
  200. </tr>
  201. <tr data-order="rejects" id="_rejects">
  202. <td class="attributes"><code>
  203. public
  204. struct
  205. </code>
  206. </td>
  207. <td class="name"><div>
  208. <a class="anchor" href="#_rejects">#</a>
  209. <code><a href="source-class-Mandrill_Exports.html#44-60" title="Go to source code">rejects</a>( <span>string <var>$notify_email</var> = <span class="php-keyword1">null</span></span> )</code>
  210. <div class="description short">
  211. <p>Begins an export of your rejection blacklist. The blacklist will be exported
  212. to a zip archive containing a single file named rejects.csv that includes the
  213. following fields: email, reason, detail, created_at, expires_at, last_event_at,
  214. expires_at.</p>
  215. </div>
  216. <div class="description detailed hidden">
  217. <p>Begins an export of your rejection blacklist. The blacklist will be exported
  218. to a zip archive containing a single file named rejects.csv that includes the
  219. following fields: email, reason, detail, created_at, expires_at, last_event_at,
  220. expires_at.</p>
  221. <h4>Parameters</h4>
  222. <div class="list"><dl>
  223. <dt><var>$notify_email</var></dt>
  224. <dd><code>string</code><br>$notify_email an optional email address to notify when the export job has
  225. finished.</dd>
  226. </dl></div>
  227. <h4>Returns</h4>
  228. <div class="list">
  229. <code>struct</code><br>information about the rejects export job that was started - id string the unique
  230. identifier for this Export. Use this identifier when checking the export job's
  231. status - created_at string the date and time that the export job was created as
  232. a UTC string in YYYY-MM-DD HH:MM:SS format - type string the type of the export
  233. job - finished_at string the date and time that the export job was finished as a
  234. UTC string in YYYY-MM-DD HH:MM:SS format, or null for jobs that have not run -
  235. state string the export job's state - result_url string the url for the export
  236. job's results, if the job is complete<br />
  237. </div>
  238. </div>
  239. </div></td>
  240. </tr>
  241. <tr data-order="whitelist" id="_whitelist">
  242. <td class="attributes"><code>
  243. public
  244. struct
  245. </code>
  246. </td>
  247. <td class="name"><div>
  248. <a class="anchor" href="#_whitelist">#</a>
  249. <code><a href="source-class-Mandrill_Exports.html#62-78" title="Go to source code">whitelist</a>( <span>string <var>$notify_email</var> = <span class="php-keyword1">null</span></span> )</code>
  250. <div class="description short">
  251. <p>Begins an export of your rejection whitelist. The whitelist will be exported
  252. to a zip archive containing a single file named whitelist.csv that includes the
  253. following fields: email, detail, created_at.</p>
  254. </div>
  255. <div class="description detailed hidden">
  256. <p>Begins an export of your rejection whitelist. The whitelist will be exported
  257. to a zip archive containing a single file named whitelist.csv that includes the
  258. following fields: email, detail, created_at.</p>
  259. <h4>Parameters</h4>
  260. <div class="list"><dl>
  261. <dt><var>$notify_email</var></dt>
  262. <dd><code>string</code><br>$notify_email an optional email address to notify when the export job has
  263. finished.</dd>
  264. </dl></div>
  265. <h4>Returns</h4>
  266. <div class="list">
  267. <code>struct</code><br>information about the whitelist export job that was started - id string the
  268. unique identifier for this Export. Use this identifier when checking the export
  269. job's status - created_at string the date and time that the export job was
  270. created as a UTC string in YYYY-MM-DD HH:MM:SS format - type string the type of
  271. the export job - finished_at string the date and time that the export job was
  272. finished as a UTC string in YYYY-MM-DD HH:MM:SS format, or null for jobs that
  273. have not run - state string the export job's state - result_url string the url
  274. for the export job's results, if the job is complete<br />
  275. </div>
  276. </div>
  277. </div></td>
  278. </tr>
  279. <tr data-order="activity" id="_activity">
  280. <td class="attributes"><code>
  281. public
  282. struct
  283. </code>
  284. </td>
  285. <td class="name"><div>
  286. <a class="anchor" href="#_activity">#</a>
  287. <code><a href="source-class-Mandrill_Exports.html#80-108" title="Go to source code">activity</a>( <span>string <var>$notify_email</var> = <span class="php-keyword1">null</span></span>, <span>string <var>$date_from</var> = <span class="php-keyword1">null</span></span>, <span>string <var>$date_to</var> = <span class="php-keyword1">null</span></span>, <span>array <var>$tags</var> = <span class="php-keyword1">null</span></span>, <span>array <var>$senders</var> = <span class="php-keyword1">null</span></span>, <span>array <var>$states</var> = <span class="php-keyword1">null</span></span>, <span>array <var>$api_keys</var> = <span class="php-keyword1">null</span></span> )</code>
  288. <div class="description short">
  289. <p>Begins an export of your activity history. The activity will be exported to a
  290. zip archive containing a single file named activity.csv in the same format as
  291. you would be able to export from your account's activity view. It includes the
  292. following fields: Date, Email Address, Sender, Subject, Status, Tags, Opens,
  293. Clicks, Bounce Detail. If you have configured any custom metadata fields, they
  294. will be included in the exported data.</p>
  295. </div>
  296. <div class="description detailed hidden">
  297. <p>Begins an export of your activity history. The activity will be exported to a
  298. zip archive containing a single file named activity.csv in the same format as
  299. you would be able to export from your account's activity view. It includes the
  300. following fields: Date, Email Address, Sender, Subject, Status, Tags, Opens,
  301. Clicks, Bounce Detail. If you have configured any custom metadata fields, they
  302. will be included in the exported data.</p>
  303. <h4>Parameters</h4>
  304. <div class="list"><dl>
  305. <dt><var>$notify_email</var></dt>
  306. <dd><code>string</code><br>$notify_email an optional email address to notify when the export job has
  307. finished</dd>
  308. <dt><var>$date_from</var></dt>
  309. <dd><code>string</code><br>$date_from start date as a UTC string in YYYY-MM-DD HH:MM:SS format</dd>
  310. <dt><var>$date_to</var></dt>
  311. <dd><code>string</code><br>$date_to end date as a UTC string in YYYY-MM-DD HH:MM:SS format</dd>
  312. <dt><var>$tags</var></dt>
  313. <dd><code>array</code><br>$tags an array of tag names to narrow the export to; will match messages that
  314. contain ANY of the tags - tags[] string a tag name</dd>
  315. <dt><var>$senders</var></dt>
  316. <dd><code>array</code><br>$senders an array of senders to narrow the export to - senders[] string a sender
  317. address</dd>
  318. <dt><var>$states</var></dt>
  319. <dd><code>array</code><br>$states an array of states to narrow the export to; messages with ANY of the
  320. states will be included - states[] string a message state</dd>
  321. <dt><var>$api_keys</var></dt>
  322. <dd><code>array</code><br>$api_keys an array of api keys to narrow the export to; messsagse sent with ANY
  323. of the keys will be included - api_keys[] string an API key associated with your
  324. account</dd>
  325. </dl></div>
  326. <h4>Returns</h4>
  327. <div class="list">
  328. <code>struct</code><br>information about the activity export job that was started - id string the
  329. unique identifier for this Export. Use this identifier when checking the export
  330. job's status - created_at string the date and time that the export job was
  331. created as a UTC string in YYYY-MM-DD HH:MM:SS format - type string the type of
  332. the export job - finished_at string the date and time that the export job was
  333. finished as a UTC string in YYYY-MM-DD HH:MM:SS format, or null for jobs that
  334. have not run - state string the export job's state - result_url string the url
  335. for the export job's results, if the job is complete<br />
  336. </div>
  337. </div>
  338. </div></td>
  339. </tr>
  340. </table>
  341. </div>
  342. <div id="footer">
  343. API documentation generated by <a href="http://apigen.org">ApiGen 2.8.0</a>
  344. </div>
  345. </div>
  346. </div>
  347. </body>
  348. </html>