I've provided a few data model classes to help you get started.

These Java classes represent the data that Etsy API will return to us.

Download them in the link in the teacher's notes.

Once you have them downloaded, go ahead and unzip them, and

we can see what classes are included.

We're gonna wanna go ahead and take these classes, copy them,

and paste them into our project in Android Studio.

In Android Studio, I'm gonna create a new package to keep my code organized.

I'm gonna call it model.

And in model, I'm gonna go ahead and paste in those classes.

If we open one of these classes, for

instance image, we can see it's a simple class with properties.

The classes are all parcelable,

which allows us to easily use them with fragments and activities.

You're hopefully familiar with parcelable data, but if not, check out the links

in the teacher's notes to where we've already covered this at TreeHouse.

To understand why they're modeled this way, let's look at the documentation for

the API we're using.

Here on the Etsy Developers site, let's click on Documentation.

In Documentation, we can find all the information we need to connect and

access Etsy's data.

Let's look at the API Reference.

Here we can see all the different types of data we can get back from the Etsy API.

We're gonna be looking for listings, so let's go ahead and click on Listing.

If we scroll down a little bit, we'll be able to see an overview of what a listing

is, and it also lists a few different properties and fields that a listing has.

If we keep scrolling, we're gonna find information about how to search for

listings.

By default,

the method findAllListingActive returns all the active listings on Etsy.

This is exactly what we want, so let's go ahead and click on it.

And we can see here that this provides an overview of how to use this method.

It provides the method name, the HTTP protocol we need,

the URI and a whole list of parameters.

We can see that the method is found at /listing/active and it uses HTTP GET.

Let's break down the API call, so we can understand each part.

The Etsy endpoint is [SOUND]

https://openapi.etsy.com/v2.

[SOUND] Next, is the method name, which is /listings/active.

[SOUND] Next, we include the URL parameters that indicate we want the shop

and the image data returned along with the listing data.

This will make it so

we don't have to make additional API calls once we get the listing data.

Finally, [SOUND] at the very end, we're going to append our API key.

If we make this API call in our browser, we can see what data gets returned.

Let's go ahead and do that now.

So open a new tab and we'll just type in our call that we're gonna make,

[SOUND] openapi.etsy.com/v2/listings/active,

and we need to include, using the includes,

the images and shop and append our API key.

And we need to make sure we're using our current API key for this, so

let's go ahead and go to Android Studio and paste in the API key from our app.

Switching back to Chrome, I'm just gonna go ahead and

paste in our API key at the end.

And let's go ahead and make that call.

And we can see what gets returned to us.

It's a JSONObject and it has many fields included in it.

First, it gives us a count of how many objects there are that

can be possibly returned.

And then it starts listing them out in a JSON array.

If you look here, we can see that a JSON array has a number of listings included,

and within that,

are also the images that we asked to be included using the include statement.

And if we keep scrolling down, we can also see the shop data is included as well,

which we requested in the include statement.

If we switch back to Android Studio, let's take a look at the ActiveListings class,

we can see that this directly mirrors the result from the API.

So we have the count and an array of listing objects and if we go ahead and

go into the Listing objects class, we can see that this has

the exact same properties that were being passed back to us from the API.

Let's take a break and when we return,

we can start using these classes to make an API request.