https://github.com/bazaarvoice/bv-android-sdk-conversations-example
https://github.com/bazaarvoice/bv-android-sdk-conversations-example
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/bazaarvoice/bv-android-sdk-conversations-example
- Owner: bazaarvoice
- License: other
- Created: 2017-08-07T16:44:54.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2019-07-22T20:17:55.000Z (almost 7 years ago)
- Last Synced: 2025-02-15T08:30:58.237Z (over 1 year ago)
- Language: Kotlin
- Size: 345 KB
- Stars: 0
- Watchers: 11
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Conversations Example App
Follow the [Installation Instructions](https://bazaarvoice.github.io/bv-android-sdk/installation.html#configure-bvsdk)
to generate your bvsdk_config_staging.json and bvsdk_config_prod.json files and add them to the
```app/src/main/assets/``` directory.
You will need to add in a valid product id, and author id in the
```app/src/main/com/example/conversations/Constants.java``` file.
If you launch ```MainActivity.java``` then you should see 2 buttons. One to Display Reviews, and one
to Submit a Review.
## Display Reviews
In the ```DisplayReviewsActivity.java``` a call is being made to display reviews.
## Submit Review
In the ```SubmitReviewsActivity.java``` a call is being made to submit a review.
You may see some form errors if your request does not include all of the field
required per your configuration...
Once you go back and edit the Request with the required params, you should now be
able to submit successfully...
## Common Errors
### Submitting with ```Action.Preview``` instead of ```Action.Submit```
When you intend for submission requests to actually exist on your backend, you must ensure
that you are submitting with ```Action.Submit```.
Submitting with ```Action.Preview``` is useful when you do not want to be spamming your
environment with fake data, or if you simply want to see a submission form from the
```response.getFormData()``` call.
### Not catching the errors in the ```BVCallback#onSuccess(response)``` method.
A review will only be considered successful when ```response.getHasErrors()``` returns false.
All ```FormError```, and BV API ```Error``` objects are routed to the
```BVCallback#onSuccess(ResponseType response)``` method for your callback.
You should check
```response.getHasErrors()``` to see if it has either type of error, which you can get
from calling ```response.getFormErrors()``` and ```response.getErrors()```.
The ```BVCallback#onFailure(BazaarException exception)``` method is only called when an a
non-API related error happens, such as no-network, etc.
## FAQ
### Badges
```java
if (response.getHasErrors()) {
// handle it
return;
}
final List reviews = response.getResults();
final Review review = reviews.get(position);
final Map badgeMap = review.getBadges();
for (Map.Entry badgeEntry : badgeMap.entrySet()) {
final Badge badge = badgeEntry.getValue();
final String badgeId = badge.getId();
final String contentType = badge.getContentType();
}
```
## More info
* [Github repo](https://github.com/bazaarvoice/bv-android-sdk)
* [Docs](https://bazaarvoice.github.io/bv-android-sdk/index.html)
* [Generate config files](https://bazaarvoice.github.io/bv-android-sdk/installation.html#configure-bvsdk)
* [More comprehensive demos](https://bazaarvoice.github.io/bv-android-sdk/example_projects.html)