显示和提交API

Bazaarvoice移动sdk提供了对Bazaarvoice提供的大多数核心产品的访问。必威手机版本要了解更多信息，请参阅Mobile SDK文档主页．

本文档解释了使用Mobile SDK向Bazaarvoice显示和提交消费者商店评论(包括商店特定的元数据)的机制。

简介

使用Bazaarvoice移动sdk来启用商店对话功能，例如显示商店评论和提交商店的评论和照片。该API与用于产品评论的对话API非常相似，只不过BVSDK为商店提供了额外的元信息，比如地理位置。联系Bazaarvoice为商店建立对话。

安装说明

使用Gradle安装

包括Maven中央存储库，并将适当的Bazaarvoice Mobile SDK模块添加到您的依赖项中:

依赖{compile 'com.bazaarvoice.bvandroidsdk:conversations:{BV_SDK_VERSION}。+' compile 'com.google.android.gms:play-services-ads:9。{YOUR_PLAY_SERVICES_VERSION}' compile 'com.android.support:recyclerview-v7:25。{YOUR_SUPPORT_LIBRARY_VERSION}'}存储库{mavenCentral()}

取代{令牌}，包括括号，并加上适当的值。请参阅安装指南{BV_SDK_VERSION}．

扩展应用程序

创建一个可扩展的类android.app.Application，并使用其构建器初始化Mobile SDK。

中可以找到构建选项的完整列表BVSDK.java．

在下面的例子中，YOUR_CLIENT_ID表示您的客户名称，例如“bazaarvoice”。如果您不确定客户端ID或API键值，请联系Bazaarvoice的支持或者你的实现团队。

公共类MyApplication扩展Application{@覆盖公共无效onCreate(){super.onCreate();BVSDK。builder(application, bazaarenenvironment . production) . loglevel (BVLogLevel.VERBOSE) //可选:设置日志级别。. dryrunanalytics (false) //可选:只设置分析为日志，不发起网络请求。.okHttpClient(okHttpClient) //可选:使用您自己的okHttpClient实例.build();}}

应用程序清单文件

将以下内容添加到您的AndroidManifest.xml文件。

<！——为应用程序条目设置类的名称——>  < /应用程序>

显示商店

你可以通过两种方式获取store和store元信息:通过已知的store id，或者使用limit和offset参数。从BulkStoreRequest申请类和使用权限构建器()构造函数，这取决于您希望如何从存储提要请求存储。存储包含的元信息，例如产品id、描述和地理描述BVStore对象。

按商店ID请求散装商店

BVConversationsClient客户端= new BVConversationsClient. builder (BVSDK.getInstance()).build();//使用一个实例BulkStoreRequest storesRequest = new BulkStoreRequest. builder (TEST_BULK_PRODUCT_IDS) .build();client.prepareCall (storesRequest)。loadAsync(new ConversationsCallback() {@Override public void onSuccess(BulkStoreResponse response){//调用主线程response. getresults ();@覆盖公共无效onFailure(BazaarException异常){//调用主线程日志。d(“开发”,exception.getLocalizedMessage ());} }）;

大量存储要求限制和抵消

BVConversationsClient客户端= new BVConversationsClient. builder (BVSDK.getInstance()).build();//使用一个实例BulkStoreRequest storesRequest = new BulkStoreRequest. builder (20,0) .build();client.prepareCall (storesRequest)。loadAsync(new ConversationsCallback() {@Override public void onSuccess(BulkStoreResponse response){//调用主线程response. getresults ();@覆盖公共无效onFailure(BazaarException异常){//调用主线程日志。d(“开发”,exception.getLocalizedMessage ());} }）;

展示商店评论

请求对商店的评论是通过StoreReviewsRequest类。使用限制和偏移量分页参数折叠更多BVReview对象作为最终用户滚动浏览评论时的对象。调整参数，如过滤器和排序StoreReviewsRequest #建设者类。请求审查的例子如下:

BVConversationsClient客户端= new BVConversationsClient. builder (BVSDK.getInstance()).build();//使用一个实例StoreReviewsRequest reviewsRequest = new StoreReviewsRequest构建器(TEST_PRODUCT_ID, 20,0) . addsort (ReviewOptions.Sort. sort)。评级，SortOrder.DESC) .build();client.prepareCall (reviewsRequest)。loadAsync(new ConversationsCallback() {@Override public void onSuccess(storeereviewresponse response){//调用主线程response. getresults ();@覆盖公共无效onFailure(BazaarException异常){//调用主线程日志。d(“开发”,exception.getLocalizedMessage ());} }）;

提交对商店的评论

方法提交商店评论StoreReviewSubmissionRequestAPI。下面是如何使用此API的示例。

BVConversationsClient客户端= new BVConversationsClient. builder (BVSDK.getInstance()).build();//使用一个实例StoreReviewSubmissionRequest submission = new StoreReviewSubmissionRequest. builder (Action。预览，productId) //.fingerPrint(blackbox) //在使用iovation SDK时取消评论我。usernickname ("mcfly") .userEmail("flymcfly@bar.com") .user("mrmcfly" + Math.random()) .rating(5) .title("最优秀!").reviewText("这是最伟大的商店，已经是，或将是!").sendEmailAlertWhenCommented(true) .sendEmailAlertWhenPublished(true) .agreedToTermsAndConditions(true) .addPhoto(localImageFile， "Awesome照片!").build();client.prepareCall(提交)。loadAsync(new ConversationsCallback() {@Override public void onSuccess(storeereviewsubmissionresponse response) {showDialogWithMessage("Successful review submission.");} @覆盖公共无效onFailure(BazaarException异常){showDialogWithMessage(exception. getmessage ());} }）;