Skip to content

criteo/criteo-api-retailmedia-php-sdk

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
.openapi-generator
.openapi-generator
 
 
docs
docs
 
 
lib
lib
 
 
test
test
 
 
.gitignore
.gitignore
 
 
.php-cs-fixer.dist.php
.php-cs-fixer.dist.php
 
 
README.md
README.md
 
 
composer.json
composer.json
 
 
composer.lock
composer.lock
 
 
phpunit.xml.dist
phpunit.xml.dist
 
 

Repository files navigation

Introduction

API Client Libraries can facilitate your use of the Criteo API allowing you to build unique and customized solutions to serve your businesses and clients. These libraries can reduce the amount of code you need to write in order to start accessing Criteo programmatically. They also can help expedite troubleshooting, should you encounter any issues.

More information on how to use Criteo API and these SDKs can be found at: https://developers.criteo.com/.

This PHP package is automatically generated by the OpenAPI Generator project:

  • Package version: 0.0.241029
  • Build package: org.openapitools.codegen.languages.PhpClientCodegen

Requirements

This project is tested with PHP 8.0. However it should work fine with PHP 7.4 too.

Installation & Usage

Composer

To install the bindings via Composer:

either run the following command: composer require criteo/criteo-api-retailmedia-sdk:0.0.241029

or add the following to composer.json:

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/criteo/criteo-api-retailmedia-php-sdk.git"
    }
  ],
  "require": {
    "criteo/criteo-api-retailmedia-php-sdk": "*@dev"
  }
}

Then run composer install

Manual Installation

Download the files and include autoload.php:

    require_once('/path/to/criteo-api-retailmedia-sdk/vendor/autoload.php');

Tests

To run the unit tests:

composer run-script test

Example

Please see test/ExampleApplication.php for an example on how to perform a simple call.

Documentation for API Endpoints

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

Class Method HTTP request Description
AccountsApi createPrivateMarketDemandSellerAccount POST /preview/retail-media/account-management/accounts/{accountId}/create-seller-account
AccountsApi getApiExternalV1AccountPrivateMarketChildAccountsByAccountId GET /preview/retail-media/account-management/accounts/{accountId}/private-market-child-accounts
AccountsApi getApiV1ExternalAccounts GET /preview/retail-media/accounts
AccountsApi grantConsent POST /preview/retail-media/accounts/{accountId}/grant-consent
AccountsApi updateSellers PUT /preview/retail-media/account-management/accounts/{accountId}/sellers
AnalyticsApi generateAsyncAccountsReport POST /preview/retail-media/reports/accounts
AnalyticsApi generateAsyncCampaignsReport POST /preview/retail-media/reports/campaigns
AnalyticsApi generateAsyncLineItemsReport POST /preview/retail-media/reports/line-items
AnalyticsApi generateSyncAttributedTransactionsReport POST /preview/retail-media/reports/sync/attributed-transactions
AnalyticsApi generateSyncCampaignsReport POST /preview/retail-media/reports/sync/campaigns
AnalyticsApi generateSyncLineItemsReport POST /preview/retail-media/reports/sync/line-items
AnalyticsApi getAsyncExportOutput GET /preview/retail-media/reports/{reportId}/output
AnalyticsApi getAsyncExportStatus GET /preview/retail-media/reports/{reportId}/status
AudienceApi bulkCreateAudienceSegments POST /preview/retail-media/accounts/{account-id}/audience-segments/create
AudienceApi bulkDeleteAudienceSegments POST /preview/retail-media/accounts/{account-id}/audience-segments/delete
AudienceApi bulkUpdateAudienceSegments PATCH /preview/retail-media/accounts/{account-id}/audience-segments
AudienceApi deleteContactListIdentifiers POST /preview/retail-media/audience-segments/{audience-segment-id}/contact-list/clear
AudienceApi getAudienceSegmentContactListStatistics GET /preview/retail-media/accounts/{account-id}/audience-segments/{audience-segment-id}/contact-list
AudienceApi searchAudienceSegments POST /preview/retail-media/accounts/{account-id}/audience-segments/search
AudienceApi searchAudiences POST /preview/retail-media/accounts/{account-id}/audiences/search
AudienceApi updateContactListIdentifiers POST /preview/retail-media/audience-segments/{audience-segment-id}/contact-list/add-remove
BalanceApi getApiV2ExternalAccountBalancesByAccountId GET /preview/retail-media/accounts/{account-id}/balances
BalanceApi getApiV2ExternalAccountByAccountIdBalancesbalanceId GET /preview/retail-media/accounts/{account-id}/balances/{balance-id}
BalanceApi getBalanceHistory GET /preview/retail-media/balances/{balanceId}/history
BalanceApi patchApiV2ExternalAccountByAccountIdBalancesbalanceId PATCH /preview/retail-media/accounts/{account-id}/balances/{balance-id}
BalanceApi postApiV2ExternalAccountAddFundsByAccountIdBalancesbalanceId POST /preview/retail-media/accounts/{account-id}/balances/{balance-id}/add-funds
BalanceApi postApiV2ExternalAccountBalancesByAccountId POST /preview/retail-media/accounts/{account-id}/balances
BalanceApi postApiV2ExternalAccountChangeDatesByAccountIdBalancesbalanceId POST /preview/retail-media/accounts/{account-id}/balances/{balance-id}/change-dates
CampaignApi addRemoveKeywords POST /preview/retail-media/line-items/{id}/keywords/add-remove
CampaignApi appendPromotedProducts POST /preview/retail-media/line-items/{line-item-id}/products/append
CampaignApi deleteApi202210ExternalLineItemProductButtonsByLineItemIdProductButtonId DELETE /preview/retail-media/line-items/{line-item-id}/product-buttons/{product-button-id}
CampaignApi deletePromotedProducts POST /preview/retail-media/line-items/{line-item-id}/products/delete
CampaignApi fetchKeywords GET /preview/retail-media/line-items/{id}/keywords
CampaignApi fetchPromotedProducts GET /preview/retail-media/line-items/{line-item-id}/products
CampaignApi fetchProposal GET /preview/retail-media/preferred-deal-line-items/{id}/proposal
CampaignApi getApi202210ExternalLineItemProductButtonsByLineItemId GET /preview/retail-media/line-items/{line-item-id}/product-buttons
CampaignApi getApi202210ExternalLineItemProductButtonsByLineItemIdProductButtonId GET /preview/retail-media/line-items/{line-item-id}/product-buttons/{product-button-id}
CampaignApi getApiV1ExternalAccountBrandsByAccountId GET /preview/retail-media/accounts/{accountId}/brands
CampaignApi getApiV1ExternalAccountRetailersByAccountId GET /preview/retail-media/accounts/{accountId}/retailers
CampaignApi getApiV1ExternalRetailerBrandsByRetailerId GET /preview/retail-media/retailers/{retailerId}/brands
CampaignApi getApiV1ExternalRetailerByRetailerIdSellerBySeller GET /preview/retail-media/retailers/{retailerId}/sellers/{seller}
CampaignApi getApiV1ExternalRetailerCategoryCpcRatesByRetailerId GET /preview/retail-media/retailers/{retailer-id}/cpc-rates
CampaignApi getApiV1ExternalRetailerPlacementsByRetailerId GET /preview/retail-media/retailers/{retailer-id}/placements
CampaignApi getApiV2ExternalAccountByAccountIdCreativescreativeId GET /preview/retail-media/accounts/{account-id}/creatives/{creative-id}
CampaignApi getApiV2ExternalCampaignPreferredLineItemsByCampaignId GET /preview/retail-media/campaigns/{campaign-id}/preferred-line-items
CampaignApi getApiV2ExternalLineItemBidMultipliersByLineItemId GET /preview/retail-media/line-items/{line-item-id}/bid-multipliers
CampaignApi getApiV2ExternalPreferredLineItemByLineItemId GET /preview/retail-media/preferred-line-items/{line-item-id}
CampaignApi getInsertionOrderHistoryChangeDataCaptureV2 GET /preview/retail-media/insertion-order-history/{insertionOrderId}/change-data-capture
CampaignApi getRecommendedKeywords GET /preview/retail-media/line-items/{externalLineItemId}/keywords/recommended
CampaignApi getSkuByProductId POST /preview/retail-media/catalogs/sku/search/accounts/{accountId}/retailers/{retailerId}/by-id
CampaignApi pausePromotedProducts POST /preview/retail-media/line-items/{line-item-id}/products/pause
CampaignApi postApi202110ExternalCampaignPreferredLineItemsByCampaignId POST /preview/retail-media/campaigns/{campaign-id}/preferred-line-items
CampaignApi postApi202210ExternalLineItemProductButtonsCreateByLineItemId POST /preview/retail-media/line-items/{line-item-id}/product-buttons/create
CampaignApi postApiV1ExternalAccountCatalogsSellersByAccountId POST /preview/retail-media/accounts/{accountId}/catalogs/sellers
CampaignApi postApiV1ExternalCatalogsSkuRetrieval POST /preview/retail-media/catalogs/sku-retrieval
CampaignApi postApiV1ExternalCatalogsSkuSearch POST /preview/retail-media/catalogs/sku-search
CampaignApi postApiV1ExternalCatalogsSkuSearchAccountIdAndRetailerId POST /preview/retail-media/catalogs/sku-search/accounts/{account-id}/retailers/{retailer-id}
CampaignApi postApiV1ExternalCatalogsSkuSearchRetailerByRetailerId POST /preview/retail-media/catalogs/sku/search/retailers/{retailer-id}
CampaignApi postApiV2ExternalAccountCreativesByAccountId POST /preview/retail-media/accounts/{account-id}/creatives
CampaignApi postApiV2ExternalAccountCreativesSearchByAccountId POST /preview/retail-media/accounts/{account-id}/creatives/search
CampaignApi putApi202110ExternalPreferredLineItemByLineItemId PUT /preview/retail-media/preferred-line-items/{line-item-id}
CampaignApi putApi202210ExternalLineItemProductButtonsByLineItemIdProductButtonId PUT /preview/retail-media/line-items/{line-item-id}/product-buttons/{product-button-id}
CampaignApi putApiV2ExternalAccountByAccountIdCreativescreativeId PUT /preview/retail-media/accounts/{account-id}/creatives/{creative-id}
CampaignApi putApiV2ExternalLineItemBidMultipliersByLineItemId PUT /preview/retail-media/line-items/{line-item-id}/bid-multipliers
CampaignApi setKeywordBids POST /preview/retail-media/line-items/{id}/keywords/set-bid
CampaignApi submitProposal POST /preview/retail-media/preferred-deal-line-items/{id}/proposal/submit
CampaignApi unpausePromotedProducts POST /preview/retail-media/line-items/{line-item-id}/products/unpause
CatalogApi previewRetailMediaCatalogProductsBatchPost POST /preview/retail-media/catalog/products/batch
CatalogApi previewRetailMediaCatalogProductsBatchReportOperationTokenGet GET /preview/retail-media/catalog/products/batch/report/{operation-token}
GatewayApi getCurrentApplication GET /preview/retail-media/me
OnSiteRecommendationApi chatbotProductRecommendations POST /preview/retail-media/chatbot-catalogs/{catalogid}/product-recommendations

Documentation For Models

Documentation For Authorization

oauth

  • Type: OAuth
  • Flow: application
  • Authorization URL:
  • Scopes: N/A

oauth

Author

Criteo

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.

About

Retail Media SDKs

Resources

Readme
Activity
Custom properties

Stars

2 stars

Watchers

9 watching

Forks

2 forks
Report repository

Releases

162 tags

Packages

No packages published

Languages