* 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); } } ``` Vous devriez obtenir des résultats similaires à cet exemple. ``` =============================================================== 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 ``` # Génération d'un ensemble de données à l'aide du service AWS Marketplace Commerce Analytics Une fois inscrit au service AWS Marketplace Commerce Analytics, vous pouvez accéder à vos rapports d'utilisation, d'abonnement et de facturation via le AWS CLI et AWS SDK pour Java. Les données que vous demandez à l'aide des outils du SDK vous sont fournies sous Compte AWS forme de jeux de données. La plupart des ensembles de données correspondent aux mêmes données que les rapports à base de texte disponibles sur [Portail de gestion AWS Marketplace](https://aws.amazon.com/marketplace/management/tour). Pour de plus amples informations, veuillez consulter [Accès aux données sur les produits et les clients avec le service AWS Marketplace Commerce Analytics](commerce-analytics-service.md). Ces sections fournissent des informations sur les paramètres, les réponses et les sorties liés aux ensembles de données générés par le Service d'analyse du commerce. **Topics** + [`GenerateDataSet` paramètres](#generate-data-set-parameters) + [Réponses](#responses) + [Outputs](#outputs) ## `GenerateDataSet` paramètres Le service AWS Marketplace Commerce Analytics propose une méthode que vous pouvez utiliser pour demander que des ensembles de données soient publiés dans votre compartiment Amazon S3. `GenerateDataSet` Le tableau suivant répertorie les paramètres pour `GenerateDataSet`. **Paramètres de l'ensemble de données** | **Champ** | **Description** | | --- | --- | | Type d'ensemble de données | Cet ensemble de données est renvoyé comme résultat de la demande. | | Date de publication de l'ensemble de données | Date à laquelle un ensemble de données a été publié. Pour les ensembles de données quotidiens, indiquez une date avec un niveau de granularité jour pour le jour voulu. Pour les ensembles de données mensuels, indiquez une date avec un niveau de granularité mensuel pour le mois voulu. La valeur jour est ignorée. | | Nom du rôle ARN | ARN du rôle avec une stratégie d'autorisations attachée qui fournit le service avec l'accès à vos ressources. | | Nom du compartiment Amazon S3 de destination | Le nom (le nom convivial, pas l'ARN) du compartiment Amazon S3 de destination. Vos ensembles de données sont publiés dans cet emplacement. | | Préfixe Amazon S3 de destination | (Facultatif) Le préfixe Amazon S3 pour le jeu de données publié, similaire à un chemin de répertoire dans les systèmes de fichiers standard. Par exemple, avec le nom de compartiment `mybucket` et le préfixe `myprefix/mydatasets`, le fichier de sortie est publié sur `s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile`. Si le préfixe de la structure de répertoires n'existe pas, il est créé automatiquement. Si aucun préfixe n'est fourni, l'ensemble de données est publié sur la racine du compartiment Amazon S3. | | ARN de rubrique SNS | L'ARN de la rubrique Amazon SNS qui est notifiée lorsque le jeu de données a été publié ou en cas d'erreur. | ## Réponses Le service AWS Marketplace Commerce Analytics renvoie deux réponses. Le premier est synchrone, qui est renvoyé immédiatement, et le second est asynchrone, qui est renvoyé via Amazon SNS. La réponse synchrone est similaire à cet exemple. **Paramètres des ensemble de données** | **Champ** | **Description** | | --- | --- | | ID de demande d'ensemble de données | Identifiant unique qui représente une demande spécifique au service. Cet identifiant peut être utilisé pour établir une corrélation entre une demande avec des notifications sur la rubrique Amazon SNS. | La réponse asynchrone est publiée sous forme de document au format JSON dans votre rubrique Amazon SNS et est similaire à cet exemple. **Paramètres de l'ensemble de données** | **Champ** | **Description** | | --- | --- | | Emplacement S3 d'ensemble de données | Nom de compartiment et de clé pour l'ensemble de données diffusé. | | Data Set Meta Data Emplacement S3 | Nom de compartiment et de clé pour le fichier de métadonnées de l'ensemble de données diffusé. | | ID de demande d'ensemble de données | Identifiant unique qui représente une demande spécifique au service. Cet identifiant peut être utilisé pour établir une corrélation entre une demande avec des notifications sur la rubrique Amazon SNS. | | Réussite | « True » si l'opération a abouti, « false » dans le cas contraire. | | Message | (Facultatif) Si une erreur s'est produite (par exemple, si « Success » a la valeur « false »), ce message contient des informations sur la défaillance. | **Exemple de réponse asynchrone au format 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 } ``` ## Outputs Une fois la demande réussie, l'ensemble de données demandé est envoyé dans votre compartiment Amazon S3 sous forme de fichier .csv. Un fichier de métadonnées au format JSON est publié dans le même emplacement que le fichier de l'ensemble de données. Le fichier de métadonnées fournit des informations utiles sur l'ensemble de données et les paramètres de la demande d'origine. Le fichier de métadonnées porte le même nom que le fichier de l'ensemble de données, mais se termine par l'extension . meta.json. Le tableau suivant répertorie les champs de métadonnées dans le fichier .csv. **Champs de métadonnées** | **Champ** | **Description** | | --- | --- | | ID de demande d'ensemble de données | Identifiant unique qui représente une demande spécifique au service. Cet identifiant peut être utilisé pour établir une corrélation entre une demande avec des notifications sur la rubrique Amazon SNS. | | Data Set Coverage Range | Définit le début date/time and end date/time de la plage de couverture des données. Ces dates sont au format ISO 8601. | | Paramètres de demande d'ensemble de données | Paramètres de la demande d'origine à la méthode GenerateDataSet. | | Emplacement S3 d'ensemble de données | Nom de compartiment et de clé pour l'ensemble de données diffusé. | | Data Set Meta Data Emplacement S3 | Nom de compartiment et de clé pour le fichier de métadonnées de l'ensemble de données diffusé. | Voici un exemple de contenu de métadonnées au format 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" } } ``` Pour obtenir la liste complète des ensembles de données disponibles, y compris les dates de disponibilité, consultez la documentation du [AWS SDK](https://docs.aws.amazon.com/cli/latest/reference/marketplacecommerceanalytics/generate-data-set.html#options). # Résolution des problèmes liés au service d'analyse AWS Marketplace du commerce Vous pouvez résoudre les problèmes liés au service AWS Marketplace Commerce Analytics, qui fournit par programme des données sur les produits et les clients à partir de. AWS Marketplace Vous devrez peut-être dépanner le service Commerce Analytics lorsque vous rencontrez des erreurs ou d'autres problèmes de configuration. Les sections suivantes vous guident tout au long du processus de dépannage, en abordant les étapes de diagnostic et de résolution des problèmes courants liés au service Commerce Analytics. **Je ne peux pas accéder au service en raison d'un problème de liste d'autorisations.** Si vous n'êtes pas encore inscrit en tant que vendeur sur le AWS Marketplace, rendez-vous [Portail de gestion AWS Marketplace](https://aws.amazon.com/marketplace/management)pour vous inscrire. Si vous êtes déjà inscrit en tant que vendeur sur AWS Marketplace, contactez l'équipe chargée [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/). **Je ne peux pas demander d'ensembles de données pour une date dans le passé, même si le kit SDK indique qu'il doit être disponible pour cette date.** Même si des ensembles de données sont indiqués comme étant disponibles pour certains jours passés, nous ne disposons que des données pour les dates ultérieures à votre date d'inscription à AWS Marketplace. Si vous pensez qu'il s'agit d'une erreur, contactez l'équipe responsable des [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/). **Lorsque j'appelle le service, je reçois le message d'erreur « Impossible de me connecter à l'URL du point de terminaison : https://marketplacecom merceanalytics.eu-central-1.amazonaws.com/»** Le service d'analyse AWS Marketplace du commerce est disponible uniquement dans la région de l'est des États-Unis (Virginie du Nord). Vous devez effectuer tous les appels de Commerce Analytics Service au point de terminaison `us-east-1`. Si vous utilisez le AWS CLI, ajoutez le `--region` drapeau « » à chaque appel et spécifiez le « Région AWS as »`us-east-1`, comme indiqué dans l'exemple suivant. ``` 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 ``` **Je souhaite utiliser un bucket Amazon S3 ou un sujet Amazon SNS différent de ceux que j'ai sélectionnés lors du processus d'intégration.** Lors de votre inscription au service AWS Marketplace Commerce Analytics, vous avez spécifié un compartiment Amazon S3 et une rubrique Amazon SNS. Le processus d'intégration configure vos autorisations IAM pour autoriser le service à accéder uniquement à ces ressources spécifiques. Pour utiliser différentes ressources, vous devez modifier votre politique IAM : 1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse. 1. Choisissez **Roles (Rôles)** sur le côté gauche de la console IAM. 1. Sélectionnez **MarketplaceCommerceAnalyticsRole**. 1. Développez la section **Inline Roles (Rôles en ligne)**, si ce n'est pas déjà fait. 1. Recherchez la politique dont le nom commence par *oneClick\$1MarketplaceCommerceAnalyticsRole*et choisissez **Modifier la politique**. 1. Dans le document de stratégie, recherchez la section qui spécifie les actions relatives au service que vous souhaitez modifier. Par exemple, pour modifier votre compartiment Amazon S3, recherchez la section qui inclut les actions commençant par **s3 :** et modifiez leur sélection de **ressources** respective pour spécifier votre nouveau compartiment Amazon S3. [Pour plus d'informations sur les politiques IAM, consultez le guide suivant : \$1policies.html https://docs.aws.amazon.com/IAM/ latest/UserGuide/access](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) **Je reçois une erreur `AccessDeniedException` lorsque j'appelle l'option `GenerateDataSet`** Cela peut se produire si votre utilisateur n'a pas les autorisations nécessaires pour appeler`GenerateDataSet`. La procédure suivante décrit les étapes nécessaires pour créer une politique IAM avec ces autorisations à l'aide de la console IAM et pour ajouter les autorisations à vos utilisateurs, groupes ou rôles. **Pour utiliser l’éditeur de politique JSON afin de créer une politique** 1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse. 1. Dans le panneau de navigation de gauche, sélectionnez **Policies** (Politiques). Si vous sélectionnez **Politiques** pour la première fois, la page **Bienvenue dans les politiques gérées** s’affiche. Sélectionnez **Mise en route**. 1. En haut de la page, sélectionnez **Créer une politique**. 1. Dans la section **Éditeur de politique**, choisissez l’option **JSON**. 1. Entrez le document de politique JSON suivant : ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ] } ``` 1. Choisissez **Suivant**. **Note** Vous pouvez basculer à tout moment entre les options des éditeurs **visuel** et **JSON**. Toutefois, si vous apportez des modifications ou si vous choisissez **Suivant** dans l’éditeur **visuel**, IAM peut restructurer votre politique afin de l’optimiser pour l’éditeur visuel. Pour plus d’informations, consultez la page [Restructuration de politique](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_policies.html#troubleshoot_viseditor-restructure) dans le *Guide de l’utilisateur IAM*. 1. Sur la page **Vérifier et créer**, saisissez un **Nom de politique** et une **Description** (facultative) pour la politique que vous créez. Vérifiez les **Autorisations définies dans cette politique** pour voir les autorisations accordées par votre politique. 1. Choisissez **Create policy** (Créer une politique) pour enregistrer votre nouvelle politique. Pour activer l’accès, ajoutez des autorisations à vos utilisateurs, groupes ou rôles : + Utilisateurs et groupes dans AWS IAM Identity Center : Créez un jeu d’autorisations. Suivez les instructions de la rubrique [Création d’un jeu d’autorisations](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) du *Guide de l’utilisateur AWS IAM Identity Center *. + Utilisateurs gérés dans IAM par un fournisseur d’identité : Créez un rôle pour la fédération d’identité. Suivez les instructions de la rubrique [Création d’un rôle pour un fournisseur d’identité tiers (fédération)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) dans le *Guide de l’utilisateur IAM*. + Utilisateurs IAM : + Créez un rôle que votre utilisateur peut assumer. Suivez les instructions de la rubrique [Création d’un rôle pour un utilisateur IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) dans le *Guide de l’utilisateur IAM*. + (Non recommandé) Attachez une politique directement à un utilisateur ou ajoutez un utilisateur à un groupe d’utilisateurs. Suivez les instructions de la rubrique [Ajout d’autorisations à un utilisateur (console)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) du *Guide de l’utilisateur IAM*. **Mon problème n'est pas répertorié ici.** Contactez l'équipe responsable des [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/).