Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan Layanan Analisis AWS Marketplace Perdagangan dengan AWS CLI dan AWS SDK untuk Java
Dengan Layanan Analisis AWS Marketplace Perdagangan, Anda dapat mengakses data produk dan pelanggan secara terprogram. AWS Marketplace Layanan Analisis AWS Marketplace Perdagangan disediakan melalui [AWS SDK](https://aws.amazon.com/tools/). Anda menggunakan [AWS CLI](https://aws.amazon.com/cli/)dan [AWS SDK untuk Java](https://aws.amazon.com/sdk-for-java/)untuk berinteraksi dengan Layanan Analisis Perdagangan. Bagian ini menunjukkan kepada Anda cara menerapkan Layanan Analytics Commerce dengan menggunakan AWS CLI dan SDK for Java.
**Topics**
+ [Kebijakan IAM untuk Layanan Analisis Perdagangan](#aws-marketplace-commerce-analytics-iam-permissions)
+ [Membuat Permintaan dengan AWS CLI](#making-requests-with-aws-cli)
+ [Membuat permintaan dengan AWS SDK untuk Java](#making-requests-with-aws-java-sdk)
## Kebijakan IAM untuk Layanan Analisis Perdagangan
Untuk memungkinkan pengguna Anda menggunakan Layanan Analisis Perdagangan, izin berikut diperlukan.
Gunakan kebijakan izin IAM berikut untuk mendaftar di Layanan Analisis AWS Marketplace Perdagangan.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iam:ListRoles",
"iam:CreateRole",
"iam:CreatePolicy",
"iam:AttachRolePolicy",
"aws-marketplace-management:viewReports"
],
"Resource": "*"
}
]
}
```
------
Gunakan kebijakan izin IAM berikut untuk memungkinkan pengguna membuat permintaan ke Layanan Analisis AWS Marketplace Perdagangan.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "marketplacecommerceanalytics:GenerateDataSet",
"Resource": "*"
}
]
}
```
------
Untuk informasi selengkapnya, lihat [Membuat Kebijakan dalam konsol IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor) di *Panduan Pengguna IAM*.
## Membuat Permintaan dengan AWS CLI
Untuk memulai, unduh aplikasi [AWS CLI](https://aws.amazon.com/cli/). AWS CLI Contoh berikut membuat permintaan untuk dataset **Langganan Per Jam/Bulanan** untuk 1 Oktober 2017. Dataset ini diterbitkan ke**bucket demo**Buket Amazon S3 menggunakan awalan**prefiks**, dan pesan notifikasi dikirim ke**topik demo**Topik Amazon SNS.
```
aws marketplacecommerceanalytics generate-data-set \
--data-set-type "customer_subscriber_hourly_monthly_subscriptions" \
--data-set-publication-date "2017-10-01T00:00:00Z" \
--role-name-arn "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole" \
--destination-s3-bucket-name "demo-bucket" \
--destination-s3-prefix "demo-prefix" \
--sns-topic-arn "arn:aws:sns:us-west-2:123412341234:demo-topic"
```
Permintaan ini mengembalikan sebuah identifier yang unik untuk setiap permintaan. Anda dapat menggunakan pengenal ini untuk mengkorelasikan permintaan dengan notifikasi diterbitkan untuk topik Amazon SNS Anda. Contoh berikut adalah contoh pengenal ini.
```
{
"dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"
}
```
## Membuat permintaan dengan AWS SDK untuk Java
Untuk memulai, unduh[AWS SDK Java](https://aws.amazon.com/sdk-for-java/). AWS SDK untuk Java Contoh berikut membuat permintaan untuk dataset **Langganan Per Jam/Bulanan** untuk 1 Oktober 2015. Dataset ini diterbitkan ke**bucket demo**Buket Amazon S3 menggunakan awalan**prefiks**, dan pesan notifikasi dikirim ke**topik demo**Topik Amazon SNS.
```
/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.TimeZone;
import com.amazonaws.AmazonClientException;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.regions.Region;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.marketplacecommerceanalytics.AWSMarketplaceCommerceAnalyticsClient;
import com.amazonaws.services.marketplacecommerceanalytics.model.GenerateDataSetRequest;
import com.amazonaws.services.marketplacecommerceanalytics.model.GenerateDataSetResult;
/**
* This sample demonstrates how to make basic requests to the AWS Marketplace Commerce
* Analytics service using the AWS SDK untuk Java.
*
* 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);
}
}
```
Anda harus mengharapkan hasil yang mirip dengan contoh ini.
```
===============================================================
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
```