* Prerequisites: Follow the on-boarding guide: {URL OR SOMETHING} *
* Fill in your AWS access credentials in the provided credentials file * template, and be sure to move the file to the default location * (~/.aws/credentials) where the sample code will load the credentials from. *
* WARNING: To avoid accidental leakage of your credentials, DO NOT keep * the credentials file in your source directory. *
* http://aws.amazon.com/security-credentials */ public class MarketplaceCommerceAnalyticsSample { public static void main(String[] args) throws ParseException { /* * The ProfileCredentialsProvider will return your [default] * credential profile by reading from the credentials file located at * (~/.aws/credentials). */ AWSCredentials credentials = null; try { credentials = new ProfileCredentialsProvider().getCredentials(); } catch (Exception e) { throw new AmazonClientException("Cannot load the credentials from the credential profiles " + "file. Make sure that your credentials file is at the correct " + "location (~/.aws/credentials), and is in valid format.", e); } AWSMarketplaceCommerceAnalyticsClient client = new AWSMarketplaceCommerceAnalyticsClient(credentials); Region usEast1 = Region.getRegion(Regions.US_EAST_1); client.setRegion(usEast1); System.out.println("==============================================================="); System.out.println("Getting Started with AWS Marketplace Commerce Analytics Service"); System.out.println("===============================================================\n"); // Create a data set request with the desired parameters GenerateDataSetRequest request = new GenerateDataSetRequest(); request.setDataSetType("customer_subscriber_hourly_monthly_subscriptions"); request.setDataSetPublicationDate(convertIso8601StringToDateUtc("2014-06-09T00:00:00Z")); request.setRoleNameArn("arn:aws:iam::864545609859:role/MarketplaceCommerceAnalyticsRole"); request.setDestinationS3BucketName("awsmp-goldmine-seller"); request.setDestinationS3Prefix("java-sdk-test"); request.setSnsTopicArn("arn:aws:sns:us-west-2:864545609859:awsmp-goldmine-seller-topic"); System.out.println( String.format("Creating a request for data set %s for publication date %s.", request.getDataSetType(), request.getDataSetPublicationDate())); try { // Make the request to the service GenerateDataSetResult result = client.generateDataSet(request); // The Data Set Request ID is a unique identifier that you can use to correlate the // request with responses on your Amazon SNS topic System.out.println("Request successful, unique ID: " + result.getDataSetRequestId()); } catch (AmazonServiceException ase) { System.out.println("Caught an AmazonServiceException, which means your request made it " + "to the AWS Marketplace Commerce Analytics service, but was rejected with an " + "error response for some reason."); System.out.println("Error Message: " + ase.getMessage()); System.out.println("HTTP Status Code: " + ase.getStatusCode()); System.out.println("AWS Error Code: " + ase.getErrorCode()); System.out.println("Error Type: " + ase.getErrorType()); System.out.println("Request ID: " + ase.getRequestId()); } catch (AmazonClientException ace) { System.out.println("Caught an AmazonClientException, which means the client encountered " + "a serious internal problem while trying to communicate with the AWS Marketplace" + "Commerce Analytics service, such as not being able to access the " + "network."); System.out.println("Error Message: " + ace.getMessage()); } } private static Date convertIso8601StringToDateUtc(String dateIso8601) throws ParseException { TimeZone utcTimeZone = TimeZone.getTimeZone("UTC"); DateFormat utcDateFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssX"); utcDateFormat.setTimeZone(utcTimeZone); return utcDateFormat.parse(dateIso8601); } } ``` Cabe esperar resultados similares a este ejemplo. ``` =============================================================== Getting Started with AWS Marketplace Commerce Analytics Service =============================================================== Creating a request for data set customer_subscriber_hourly_monthly_subscriptions for publication date Sun Jun 08 17:00:00 PDT 2014. Request successful, unique ID: c59aff81-6875-11e5-a6d8-fd5dbcaa74ab ``` # Generación de un conjunto de datos mediante AWS Marketplace Commerce Analytics Service Una vez que se inscriba en AWS Marketplace Commerce Analytics Service, puede acceder a su uso, suscripción e informes de facturación a través de la AWS CLI y de AWS SDK para Java. Los datos que solicite con las herramientas de SDK se entregan a su Cuenta de AWS como conjuntos de datos. La mayoría de los conjuntos de datos corresponden a los mismos datos que los informes basados en texto disponibles en el [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour). Para obtener más información, consulte [Acceso a los datos de productos y clientes con el servicio AWS Marketplace Commerce Analytics](commerce-analytics-service.md). Estas secciones proporcionan información sobre los parámetros, las respuestas y las salidas relacionados con los conjuntos de datos generados por Commerce Analytics Service. **Topics** + [ ## `GenerateDataSet`Parámetros ](#generate-data-set-parameters) + [ ## Respuestas ](#responses) + [ ## Salidas ](#outputs) ## `GenerateDataSet`Parámetros AWS Marketplace Commerce Analytics expone un método, `GenerateDataSet`, que puede utilizar para solicitar la publicación de conjuntos de datos en un bucket de Amazon S3. En la tabla siguiente se enumeran los parámetros de `GenerateDataSet`. **Parámetros del conjunto de datos** | **Campo** | **Descripción** | | --- | --- | | Tipo de conjunto de datos | Este conjunto de datos se devolverá como resultado de la solicitud. | | Fecha de publicación del conjunto de datos | La fecha en que se publicó un conjunto de datos. Para los conjuntos de datos diarios, proporcione una fecha con el grado de detalle de nivel de día para el día que desee. Para los conjuntos de datos mensuales, proporcione una fecha con el grado de detalle de nivel de mes para el mes que desee. El valor de día no se tiene en cuenta. | | ARN del nombre de rol | El ARN del rol que tiene asociada una política de permisos que proporciona al servicio acceso a los recursos. | | Nombre del bucket de Amazon S3 de destino | El nombre (el nombre fácil de recordar, no el ARN) del bucket de Amazon S3 de destino. Los conjuntos de datos se publican en esta ubicación. | | Prefijo de Amazon S3 del destino | (Opcional) El prefijo de Amazon S3 para el conjunto de datos publicado, similar a una ruta del directorio en los sistemas de archivos estándar. Por ejemplo, si el nombre del bucket es `mybucket` y el prefijo `myprefix/mydatasets`, el archivo de salida se publica en `s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile`. Si la estructura de directorios del prefijo no existe, se crea. Si no se proporciona ningún prefijo, el conjunto de datos se publica en la raíz del bucket de Amazon S3. | | SNS Topic ARN | El ARN del tema de Amazon SNS al que se envía una notificación cuando se publique el conjunto de datos o si se produce un error. | ## Respuestas El servicio de análisis de comercio de AWS Marketplace devuelve dos respuestas. La primera es síncrona y se devuelve inmediatamente, y la segunda es asíncrona y se devuelve usando el Amazon SNS. La respuesta síncrona será similar a este ejemplo. **Parámetros del conjunto de datos** | **Campo** | **Descripción** | | --- | --- | | ID de solicitud del conjunto de datos | Identificador único que representa una solicitud específica al servicio. Este identificador se puede utilizar para correlacionar una solicitud con las notificaciones del tema de Amazon SNS. | La respuesta asíncrona se publica como un documento con formato JSON en su tema Amazon SNS y será similar a este ejemplo. **Parámetros del conjunto de datos** | **Campo** | **Descripción** | | --- | --- | | Ubicación del conjunto de datos en S3 | La clave y el nombre del bucket del conjunto de datos entregado. | | Ubicación de los metadatos del conjunto de datos en S3 | La clave y el nombre del bucket del archivo de metadatos del conjunto de datos entregado. | | ID de solicitud del conjunto de datos | Identificador único que representa una solicitud específica al servicio. Este identificador se puede utilizar para correlacionar una solicitud con las notificaciones del tema de Amazon SNS. | | Success | "True" si la operación se realiza correctamente, de lo contrario, "false". | | Mensaje | (Opcional) Si se produce un error (por ejemplo, "Correcto" es "false"), este mensaje contiene información sobre el error. | **Ejemplo de respuesta asíncrona con formato JSON** ``` { "dataSetS3Location":{ "bucketName":"demo-bucket", "key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv" }, "dataSetMetaDataS3Location":{ "bucketName":"demo-bucket", "key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json" }, "dataSetRequestId":"f65b7244-6862-11e5-80e2-c5127e17c023", "success":true } ``` ## Salidas Cuando una solicitud finaliza correctamente, el conjunto de datos solicitado se entrega en el bucket de Amazon S3 como un archivo .csv. El archivo de metadatos con formato JSON se publica en la misma ubicación que el archivo de conjunto de datos. El archivo de metadatos proporciona información útil sobre el conjunto de datos y los parámetros de la solicitud original. El archivo de metadatos tiene el mismo nombre que el archivo del conjunto de datos, pero con la extensión .meta.json. En la tabla siguiente se muestra el conjunto de campos de metadatos en el archivo .csv. **Campos de metadatos** | **Campo** | **Descripción** | | --- | --- | | ID de solicitud del conjunto de datos | Identificador único que representa una solicitud específica al servicio. Este identificador se puede utilizar para correlacionar una solicitud con las notificaciones del tema de Amazon SNS. | | Rango de cobertura del conjunto de datos | Define la fecha y hora de inicio y de finalización del rango que cubren los datos. Estas fechas están en formato ISO 8601. | | Parámetros de la solicitud del conjunto de datos | Los parámetros de solicitud originales para el método GenerateDataSet. | | Ubicación del conjunto de datos en S3 | La clave y el nombre del bucket del conjunto de datos entregado. | | Ubicación de los metadatos del conjunto de datos en S3 | La clave y el nombre del bucket del archivo de metadatos del conjunto de datos entregado. | A continuación se ofrece un ejemplo de contenido metadatos con formato JSON. ``` { "dataSetRequestId": "43d7137b-8a94-4042-a09d-c41e87f371c1", "dataSetCoverageRange": { "startDateTime": "2014-06-08T00:00:00.000Z", "endDateTime": "2014-06-08T23:59:59.000Z" }, "dataSetRequestParameters": { "sellerAccountId": "123412341234", "dataSetType": "customer_subscriber_hourly_monthly_subscriptions", "dataSetPublicationDate": "2014-06-09T00:00:00.000Z", "roleNameArn": "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole", "destinationS3BucketName": "demo-bucket", "destinationS3Prefix": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions", "snsTopicArn": "arn:aws:sns:us-west-2:123412341234:demo-topic" }, "dataSetS3Location": { "bucketName": "demo-bucket", "key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv" }, "dataSetMetaDataS3Location": { "bucketName": "demo-bucket", "key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json" } } ``` Para obtener una lista completa de los conjuntos de datos disponibles, incluidas las fechas de disponibilidad, consulte la [documentación del AWS SDK](https://docs.aws.amazon.com/cli/latest/reference/marketplacecommerceanalytics/generate-data-set.html#options). # Solución de problemas del servicio AWS Marketplace Commerce Analytics Puede solucionar problemas con el servicio AWS Marketplace Commerce Analytics, que proporciona mediante programación datos sobre productos y clientes desde. AWS Marketplace Es posible que tenga que solucionar los problemas de Commerce Analytics Service si surgen errores u otros problemas de configuración. En las siguientes secciones se explica el proceso de solución de problemas y se describen los pasos para diagnosticar y resolver problemas comunes con Commerce Analytics Service. **No puedo obtener acceso al servicio debido a un problema con la lista de permitidos.** Si aún no estás registrado como vendedor en AWS Marketplace, visita [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management)para registrarte. Si ya te has registrado como vendedor en AWS Marketplace, ponte en contacto con el equipo de [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/). **No puedo solicitar conjuntos de datos de una fecha pasada, aunque la documentación del SDK dice que deben estar disponibles para esta fecha.** Aunque se indica que los conjuntos de datos están disponibles para determinadas fechas en el pasado, solo disponemos de datos desde la hora en que se inscribió en AWS Marketplace. Si cree que esto es un error, póngase en contacto con el equipo de [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/). **Cuando llamo al servicio, recibo el mensaje de error «No se ha podido conectar a la URL del terminal: https://marketplacecom merceanalytics.eu-central-1.amazonaws.com/»** El servicio AWS Marketplace Commerce Analytics solo está disponible en la región EE.UU. Este (Virginia del Norte). Debe realizar todas las llamadas al servicio de análisis de comercio al punto de enlace `us-east-1`. Si utiliza el AWS CLI, añada el `--region` indicador «» a cada llamada y especifique el Región de AWS as`us-east-1`, tal y como se muestra en el siguiente ejemplo. ``` aws marketplacecommerceanalytics generate-data-set \ --data-set-type "customer_subscriber_hourly_monthly_subscriptions" \ --data-set-publication-date "2016-04-21T00:00:00Z" \ --role-name-arn "arn:aws:iam::138136086619:role/MarketplaceCommerceAnalyticsRole" \ --destination-s3-bucket-name "marketplace-analytics-service" \ --destination-s3-prefix "test-prefix" \ --sns-topic-arn "arn:aws:sns:eu-central-1:138136086619:Marketplace_Analytics_Service_Notice" \ --region us-east-1 ``` **Quiero utilizar un bucket de Amazon S3 o un tema de Amazon SNS distinto de los que seleccioné durante el proceso de incorporación.** Al inscribirse en el servicio AWS Marketplace Commerce Analytics, especificó un bucket de Amazon S3 y un tema de Amazon SNS. El proceso de incorporación configura sus permisos de IAM para permitir que el servicio acceda únicamente a estos recursos específicos. Para utilizar diferentes recursos, debe modificar su política de IAM: 1. Inicie sesión en la consola de IAM Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 1. Elija **Roles** en el lado izquierdo de la consola de IAM. 1. Elija **MarketplaceCommerceAnalyticsRole**. 1. Expanda la sección **Inline Roles (Roles insertados)** si fuera necesario. 1. Busque la política con un nombre que comience por *oneClick\$1MarketplaceCommerceAnalyticsRole* y elija **Editar política**. 1. En el documento de política, busque la sección que especifica las acciones relacionadas con el servicio que quiere modificar. Por ejemplo, para cambiar el bucket de Amazon S3, busque la sección que incluye las acciones que comienzan por **s3:** y cambie los valores de **Recurso** respectivos por el bucket de Amazon S3 nuevo. [Para obtener información adicional sobre las políticas de IAM, consulte la siguiente guía: \$1policies.html https://docs.aws.amazon.com/IAM/ latest/UserGuide/access](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) **Aparece un error `AccessDeniedException` al llamar a la acción `GenerateDataSet`** Esto puede ocurrir si el usuario de no tiene los permisos necesarios para llamar a `GenerateDataSet`. El siguiente procedimiento describe los pasos necesarios para crear una política de IAM con esos permisos mediante la consola de IAM y agregar los permisos a los usuarios, grupos o funciones. **Utilización del editor de política de JSON para la creación de una política** 1. Inicie sesión en la consola de IAM Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 1. En el panel de navegación de la izquierda, elija **Políticas**. Si es la primera vez que elige **Políticas**, aparecerá la página **Welcome to Managed Policies** (Bienvenido a políticas administradas). Elija **Comenzar**. 1. En la parte superior de la página, seleccione **Crear política**. 1. En la sección **Editor de políticas**, seleccione la opción **JSON**. 1. Ingrese el siguiente documento de política JSON: ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ] } ``` 1. Elija **Siguiente**. **nota** Puede alternar entre las opciones **Visual** y **JSON** del editor en todo momento. No obstante, si realiza cambios o selecciona **Siguiente** en la opción **Visual** del editor, es posible que IAM reestructure la política, con el fin de optimizarla para el editor visual. Para obtener más información, consulte [Reestructuración de política](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_policies.html#troubleshoot_viseditor-restructure) en la *Guía del usuario de IAM*. 1. En la página **Revisar y crear**, introduzca el **Nombre de la política** y la **Descripción** (opcional) para la política que está creando. Revise los **Permisos definidos en esta política** para ver los permisos que concede la política. 1. Elija **Crear política** para guardar la nueva política. Para dar acceso, agregue permisos a los usuarios, grupos o roles: + Usuarios y grupos en AWS IAM Identity Center: Cree un conjunto de permisos. Siga las instrucciones de [Creación de un conjunto de permisos](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) en la *Guía del usuario de AWS IAM Identity Center *. + Usuarios gestionados en IAM a través de un proveedor de identidades: Cree un rol para la federación de identidades. Siga las instrucciones descritas en [Creación de un rol para un proveedor de identidad de terceros (federación)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) en la *Guía del usuario de IAM*. + Usuarios de IAM: + Cree un rol que el usuario pueda aceptar. Siga las instrucciones descritas en [Creación de un rol para un usuario de IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) en la *Guía del usuario de IAM*. + (No recomendado) Adjunte una política directamente a un usuario o agregue un usuario a un grupo de usuarios. Siga las instrucciones descritas en [Adición de permisos a un usuario (consola)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) de la *Guía del usuario de IAM*. **Mi problema no se incluye en esta lista.** Póngase en contacto con el equipo de [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/).