reportDownloadLink

Version 2024-11-01

📘

Important

The Buy with Prime API is offered as a preview and might change as we receive feedback and iterate on the interfaces. We are sharing this early documentation to help you learn about the Buy with Prime API as we write and iterate on the content.

Overview

Get the link to download a report.

Response

Return type ReportDownloadLink

Arguments

ArgumentDescription
taskId (ID required)

Specifies the identifier to retrieve a report task.

Examples


Report Download Link

Request

query Query {
  reportDownloadLink(
    taskId: "USER_EVENTS:23272b65-efac-412d-a8aa-ce8ef41bb448"
  ) {
    downloadUrl
  }
}

Response

{
  "data": {
    "reportDownloadLink": {
      "downloadUrl": "https://query-results-us-east-1-prod-259810584942.s3.amazonaws.com/ownerId%3Do-7e1a7g24-4742-43f8-8a53-73d7b73810a8/tenantId%3Dt-TPsf6fCwOP/configBundle/analytics-api-bundle/flow/user-events/taskId%3D23272b65-efac-412d-a8aa-ce8ef41bb448/ec0d6fcf_2ba0_4965_adde_5285aa5f3087.csv?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEI%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCID%2FCO0T65WwhaCNimC3XathmUU4lZRRFCFzIft3%2F%2BQ8SAiBRgoU7K%2Fokb7C47U4aPi0XIUE9pKPpJ21T4B2INfhRfSqLBQhnEAAaDDk1OTI2NTI0NTkyOCIMvhC7hpTr0pVaSl%2BdKugEbcWQDKiKfQDeN8Bzetk60zewgIcTD0myLjOC39FqbvLMd2Mt5fSW8HcfmooHiD4l5y190H3R%2F0qGP9ipob8sEMgYUGyhm5J0z4X17QsEtyGnmtxoHeRb7n%2FltkPG7VjZ2gd2F5zo1hTVrIsACIW5yJ8VQEaKHSZgCVdzw8UbgPX%2BlU34NFHrS9VFp8S8Zm%2Bmd0hNWn3irlYf4oi2%2FXx7AMYk9eM%2BXAKQxhv7xLHVE2VBAR%2FmS%2BEpHYfPHHg0%2B5tWJT3ZEYF6E%2BTpxcAxQ3HuFN49kBv7%2FAHVY5cfE2U34ddt%2FKutgQrADSrxy%2F2ygfvZRLVMAywk067yuVDNLkx8xBRmPjpnz5zDvS7zWBwZVc9EMRDJjeVFu7srfNTeL7Z%2FnWN%2FvzcDxNGF7cK5pJHPGnqJ2ye8G5c5rS1xWmggc0qvonzT9PrWvqGMDrXDSkNhu3FmdHrqLShk0JLck%2F2zf4kklFMqpwVoqP0OOY7c6OCORF7qDDTyoY779eSCbi%2Bmqk6frjwwhvuRgq%2FcYJWgEECz9RnxiKWiYH30YDpEBs1GN4jUGnCGt8evAb9tt1Aj5HxU6P16nJ%2Foi4DyWx1EOT1TOrMEnQfofntIZQt%2BHIfyXqMd2kZSHfB4Gmsq7rtsXyFWHUUNG43xZVWzIxPoQe8G8U3F5MYOHVJE0KA7CdQuUVzhyM3h9d0o1Sis%2F6Zw8tJbXxZmgkuEuxQhWk%2B%2BPrh7LNmkiT0wwRruAco5ztmDqxOrR%2FHFLK6FhBWYrTpEals6Fum7j5tv%2BXn6qetHcMjrx%2FkuQT9vBNFNUaHOSUXWLiAf%2BwQ%2BBzCrkPa0BjqoAV1VrLI6Fs2c3LsdnrGSinCmMWOhZpAUJ%2Bbe%2BpBF8Dts7ygWYUxHBGjV%2FgqJY4yzuRMYKknpQVhr6TCRifihGK%2FxwaRkz0Q89AtsZ05TInuILOFu7Cpnxp5Dos5gyCsP6gCtm8GzXpDZOqThaOadeIjP3hcv%2FmVKG5aqeF9zAzAv7mN8xCljoLwHi4hEjG5G%2FjmJo%2FeBFT8jpKmWCgvKD0%2Fkmb2R09eQfA%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240721T224517Z&X-Amz-SignedHeaders=host&X-Amz-Credential=ASIA56WFKBLUCJBFZQUO%2F20240721%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Expires=300&X-Amz-Signature=a5621fd5d3d8cdd6ffa531c9fa6d2e9ecd82bd3a90630876c8a3cf1042921b5b"
    }
  }
}

Task Id Does Not Exist

Request

query Query {
  reportDownloadLink(taskId: "invalid-task-id") {
    downloadUrl
  }
}

Response

{
  "errors": [
    {
      "message": "Querying for an invalid or expired taskId",
      "locations": [
        {
          "line": 2,
          "column": 3
        }
      ],
      "path": ["reportDownloadLink"],
      "extensions": {
        "classification": {
          "type": "ResourceNotFoundError",
          "errorType": "ResourceNotFoundException",
          "errorCode": 404
        }
      }
    }
  ],
  "data": {
    "reportDownloadLink": null
  }
}