This project is deprecated

We've built a new set of SDKs to help you use our Criteo's API.

You can find the new Java SDKs repository here : https://github.com/criteo/criteo-api-java-sdk

Criteo Marketing SDK for Java

Marketing API v.1.0

• API version: v.1.0

Automatically generated by the OpenAPI Generator

Requirements

Building the API client library requires:

1. Java 1.8+
2. Maven/Gradle

Installation

To install the API client library to your local Maven repository, simply execute:

mvn clean install

or

gradle install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn clean deploy

Refer to the OSSRH Guide for more information.

Maven users

Add this dependency to your project's POM:

<dependency>
  <groupId>com.criteo</groupId>
  <artifactId>marketing.java-client</artifactId>
  <version>1.0.29</version>
  <scope>compile</scope>
</dependency>

Gradle users

Add this dependency to your project's build file:

compile "com.criteo:marketing.java-client:1.0.29"

Others

At first generate the JAR by executing:

mvn clean package

Then manually install the following JARs:

• target/marketing.java-client-1.0.29.jar
• target/lib/*.jar

Example

Please see src/examples/java/com/criteo/marketing/ for full examples to get a valid token and make a call to the API.

Documentation for API Endpoints

All URIs are relative to https://api.criteo.com/marketing

Class	Method	HTTP request	Description
AdvertisersApi	getCampaigns	GET /v1/advertisers/{advertiserId}/campaigns	Gets all advertiser's campaigns
AdvertisersApi	getCategories	GET /v1/advertisers/{advertiserId}/categories	Gets all advertiser's categories
AdvertisersApi	getCategory	GET /v1/advertisers/{advertiserId}/categories/{categoryHashCode}	Gets a specific advertiser's category
AudiencesApi	addRemoveUsersToAudience	PATCH /v1/audiences/userlist/{audienceId}	Add/Remove users to an Audience.
AudiencesApi	createAudience	POST /v1/audiences/userlist	Create a new Audience.
AudiencesApi	deleteAudience	DELETE /v1/audiences/{audienceId}	Delete an Audience.
AudiencesApi	getAudiences	GET /v1/audiences	Get the list of Audiences.
AudiencesApi	removeUsersFromAudience	DELETE /v1/audiences/userlist/{audienceId}/users	Remove all users from an Audience.
AudiencesApi	updateAudienceMetadata	PUT /v1/audiences/{audienceId}	Update an Audience metadata.
AuthenticationApi	oAuth2TokenPost	POST /oauth2/token	Authenticates provided credentials and returns an access token
BudgetsApi	get	GET /v1/budgets	Gets budgets
CampaignsApi	getBids	GET /v1/campaigns/bids	Gets a the bids for campaigns and their categories
CampaignsApi	getCampaign	GET /v1/campaigns/{campaignId}	Gets a specific campaign
CampaignsApi	getCampaigns	GET /v1/campaigns	Gets campaigns
CampaignsApi	getCategories	GET /v1/campaigns/{campaignId}/categories	Gets categories
CampaignsApi	getCategory	GET /v1/campaigns/{campaignId}/categories/{categoryHashCode}	Gets a specific category
CampaignsApi	updateBids	PUT /v1/campaigns/bids	Update bids for campaigns and their categories
CategoriesApi	getCategories	GET /v1/categories	Gets categories
CategoriesApi	updateCategories	PUT /v1/categories	Enables/disables categories
PortfolioApi	getPortfolio	GET /v1/portfolio	Gets portfolio
PublishersApi	getStats	POST /v1/publishers/stats
SellersApi	createBudgets	POST /v1/sellers/budgets	Creates a budget for a seller/list of sellers.
SellersApi	get	GET /v1/sellers	Gets sellers details.
SellersApi	getCampaigns	GET /v1/sellers/campaigns	Gets campaigns
SellersApi	getStats	POST /v1/sellers/stats	Generates a statistics report
SellersApi	updateBids	PUT /v1/sellers/bids	Set or update a bid for a seller/list of sellers.
SellersApi	updateBudgets	PUT /v1/sellers/budgets	Updates a budget for a seller/list of sellers.
SellersV2Api	createSellerBudgets	POST /v2/crp/budgets	Create a collection of budgets.
SellersV2Api	createSellerCampaignsBySeller	POST /v2/crp/sellers/{sellerId}/seller-campaigns	Create a SellerCampaign
SellersV2Api	createSellers	POST /v2/crp/advertisers/{advertiserId}/sellers	Create new sellers for an advertiser
SellersV2Api	getAdvertiser	GET /v2/crp/advertisers/{advertiserId}	Get an advertiser.
SellersV2Api	getAdvertiserCampaigns	GET /v2/crp/advertisers/{advertiserId}/campaigns	Get the collection of CRP campaigns associated with the advertiserId.
SellersV2Api	getAdvertiserPreviewLimits	GET /v2/crp/advertisers/preview-limit	Get the collection of advertisers preview limits associated with the authorized user.
SellersV2Api	getAdvertisers	GET /v2/crp/advertisers	Get the collection of advertisers associated with the user.
SellersV2Api	getBudgetsByAdvertiser	GET /v2/crp/advertisers/{advertiserId}/budgets	Get CRP budgets for a specific advertiser
SellersV2Api	getBudgetsBySeller	GET /v2/crp/sellers/{sellerId}/budgets	Get a collection of budgets for this seller.
SellersV2Api	getBudgetsBySellerCampaignId	GET /v2/crp/seller-campaigns/{sellerCampaignId}/budgets	Get a collection of budgets for this seller campaign.
SellersV2Api	getSeller	GET /v2/crp/sellers/{sellerId}	Get details for a seller.
SellersV2Api	getSellerAdDemo	GET /v2/crp/advertisers/{advertiserId}/ad-preview	Get a preview of an HTML ad with products belonging to the provided seller
SellersV2Api	getSellerBudget	GET /v2/crp/budgets/{budgetId}	Get details for a budget.
SellersV2Api	getSellerBudgets	GET /v2/crp/budgets	Get a collection of budgets.
SellersV2Api	getSellerCampaign	GET /v2/crp/seller-campaigns/{sellerCampaignId}	Get details for a seller campaign.
SellersV2Api	getSellerCampaigns	GET /v2/crp/seller-campaigns	Get a collection of seller campaigns.
SellersV2Api	getSellerCampaignsByAdvertiser	GET /v2/crp/advertisers/{advertiserId}/seller-campaigns	Get CRP seller-campaigns for a specific advertiser
SellersV2Api	getSellerCampaignsBySeller	GET /v2/crp/sellers/{sellerId}/seller-campaigns	Get a collection of seller campaigns for this seller.
SellersV2Api	getSellers	GET /v2/crp/sellers	Get a collection of sellers.
SellersV2Api	updateSellerBudget	PATCH /v2/crp/budgets/{budgetId}	Modify a single budget.
SellersV2Api	updateSellerBudgets	PATCH /v2/crp/budgets	Modify a collection of budgets.
SellersV2Api	updateSellerCampaign	PATCH /v2/crp/seller-campaigns/{sellerCampaignId}	Update an existing seller campaign.
SellersV2Api	updateSellerCampaigns	PATCH /v2/crp/seller-campaigns	Update a collection of seller campaigns.
SellersV2StatsApi	campaigns	GET /v2/crp/stats/campaigns	Get stats by campaign.
SellersV2StatsApi	sellerCampaigns	GET /v2/crp/stats/seller-campaigns	Get stats by seller-campaign.
SellersV2StatsApi	sellers	GET /v2/crp/stats/sellers	Get stats by seller.
StatisticsApi	getCampaignReport	POST /v1/statistics/report	Generates a statistics report
StatisticsApi	getStats	POST /v1/statistics	Generates a statistics report

Documentation for Models

• AdvertiserCampaignMessage
• AdvertiserInfoMessage
• AdvertiserQuotaMessage
• AudienceCreateRequest
• AudienceCreateResponse
• AudiencePatchRequest
• AudiencePatchResponse
• AudiencePutRequest
• AudienceResponse
• AudiencesGetResponse
• BidMessage
• BudgetMessage
• CampaignBidChangeRequest
• CampaignBidChangeResponse
• CampaignBidMessage
• CampaignMessage
• CampaignReportQueryMessage
• CatalogProduct
• CatalogProductV3
• CategoryBidChangeRequest
• CategoryBidMessage
• CategoryMessage
• CategoryUpdateError
• CategoryUpdateInput
• CategoryUpdatesPerCatalog
• CategoryUpdatesPerCatalogError
• CheckResult
• ClientRegistrationRequestMessage
• ClientRegistrationResponseMessage
• CreateSellerBudgetMapiMessage
• CreateSellerCampaignMessageMapi
• CustomAttributeV3
• ErrorSource
• GoogleProduct
• GoogleProductV3
• IThrottlingConfiguration
• InlineResponse200
• Installment
• InstallmentAmount
• InstallmentV3
• LoyaltyPointsV3
• LoyatyPoints
• MapiUserMessage
• MarketplaceCampaignMessage
• MessageWithDetailsCampaignBidChangeResponse
• MessageWithDetailsCategoryUpdatesPerCatalogError
• PolicyRouteInfo
• PortfolioMessage
• Price
• ProductImporterBatch
• ProductImporterMessage
• ProductShippingDimensionV3
• ProductShippingV3
• ProductShippingWeightV3
• ProductTaxV3
• ProductUnitPricingBaseMeasureV3
• PublisherFileStatsMessage
• PublisherStatsMessage
• PublisherStatsQueryMessage
• RoutePolicy
• SellerBase
• SellerBidInfoMessage
• SellerBidsMessage
• SellerBudgetCreateMessage
• SellerBudgetInfoMessage
• SellerBudgetMessage
• SellerBudgetResponseMessage
• SellerBudgetUpdateMessage
• SellerBudgetsCreateMessage
• SellerBudgetsMessage
• SellerBudgetsUpdateMessage
• SellerCampaignMessage
• SellerCampaignUpdate
• SellerInfoMessage
• SellerMessage
• ServiceStatusCheckResult
• Shipping
• ShippingSize
• StatsQueryMessage
• StatsQueryMessageEx
• Tax
• ThrottlePolicy
• ThrottlePolicyRates
• UnitMeasure
• UpdateSellerBudgetMessage
• UpdateSellerBudgetMessageBase

Recommendation

It's recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issues.

Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.