<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1251">
<style type="text/css" style="display:none;"> P {margin-top:0;margin-bottom:0;} </style>
</head>
<body dir="ltr">
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
Hi David,</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
First of all, the status of a download request doesn't really say anything about actual usage. PREPARING and RUNNING are initial statuses that are followed by SUCCEEDED, unless something goes wrong—in which case you may see FAILED or KILLED, if cancelled.</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
Due to storage restrictions we have had to delete some older, very large downloads, which now have status FILE_ERASED.</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
If a download is used and the usage properly cited, say in a journal publication, we will flag this download by linking the citing article to the download. This information, however, is not available in the regular API. You may access this information through</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<a href="https://www.gbif.org/api/resource/search?contentType=literature&gbifDatasetKey={datasetKey}" style="" id="LPlnk390609">https://www.gbif.org/api/resource/search?contentType=literature&gbifDatasetKey={datasetKey}</a><br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
or for a specific download</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<a href="https://www.gbif.org/api/resource/search?contentType=literature&gbifDownloadKey={downloadKey}" style="" id="LPlnk225783">https://www.gbif.org/api/resource/search?contentType=literature&gbifDownloadKey={downloadKey}</a><br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
If you'd like to discuss this further, feel free to reach out to me. I would be interested in learning more about what you're planning to do with this data?</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
Thanks,</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
Daniel</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
GBIF</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<br>
</div>
<div id="appendonsend"></div>
<hr style="display:inline-block;width:98%" tabindex="-1">
<div id="divRplyFwdMsg" dir="ltr"><font face="Calibri, sans-serif" style="font-size:11pt" color="#000000"><b>From:</b> API-users <api-users-bounces@lists.gbif.org> on behalf of Herbario SANT <sant.herbarium@gmail.com><br>
<b>Sent:</b> Monday, January 20, 2020 21:25<br>
<b>To:</b> api-users@lists.gbif.org <api-users@lists.gbif.org><br>
<b>Subject:</b> [API-users] understanding download status (specially FILE_ERASED)</font>
<div> </div>
</div>
<div>
<div dir="ltr">
<div dir="ltr">
<div dir="ltr">I have a question about the results returned by the api when requesting the download activity of a dataset.</div>
<div dir="ltr"><a href="https://www.gbif.org/developer/occurrence#download">/occurrence/download/dataset/{datasetKey}</a><span class="x_gmail-Apple-tab-span" style="white-space:pre">
</span><br>
<div>
<div><br>
</div>
<div>Where can I find a description of the possible "status" of a given download? (I found at least 6 different values in our datasets activity).</div>
<div><br>
</div>
<div>I understand that KILLED, FAILED, RUNNING, PREPARING ... can all be interpreted as "nobody has (still) used that information".</div>
<div>Whereas <span style="line-height:1.5">a "SUCCEEDED" download means the opposite.</span></div>
<div><span style="line-height:1.5"><br>
</span></div>
<div><span style="line-height:1.5">But what about "<a href="http://api.gbif.org/v1/occurrence/download/0000316-140429114108248">FILE_ERASED</a>"?</span></div>
<div><span style="line-height:1.5">Does it mean the download was "SUCCEEDED" in the past, and some time later the info was deleted? (when looking at old downloads, the percentage of FILE_ERASED is much higher).</span></div>
<div><span style="line-height:1.5"><br>
</span></div>
<div><span style="line-height:1.5">If I want to evaluate real usage of a dataset along years, should I better use the sum of "SUCCEEDED + FILE_ERASED". Right?</span></div>
<div><span style="line-height:1.5"><br>
</span></div>
<div>Also, I understand that the sum of SUCCEEDED + FILE_ERASED downloads for a given dataset and year, should be the same if somebody repeats the query in the future (whereas the sum of SUCCEEDED downloads will decrease).</div>
<div><br>
</div>
<div>Thanks a lot for your help</div>
<div>David</div>
<div><br>
</div>
</div>
</div>
</div>
</div>
</div>
</body>
</html>