README

营销API为卖家提供了两个平台，他们可以使用这些平台来推广和宣传他们的产品：推广列表是eBay的一项广告服务，允许卖家为想要推广的产品设置广告活动。eBay将在搜索结果和其他营销模块中以赞助商的形式展示这些广告。如果推广列表活动中的商品售出，卖家将按销售价格收取推广列表费用，该费用为卖家指定的百分比。有关详细信息，请参阅推广列表。促销管理器为卖家提供了一种提供特定商品折扣的方式，以吸引买家浏览他们的库存。卖家可以在特定商品或整个客户订单上设置折扣（例如“20%折扣”和其他类型的优惠）。为了进一步吸引买家，eBay在买家流程中突出显示了促销预告。有关详细信息，请参阅促销管理器。在推广列表和促销管理器平台上，营销报告为卖家提供了有关其营销策略有效性的信息。这些数据使卖家能够审查和微调他们的营销工作。重要提示！卖家必须有一个有效的eBay商店订阅，并且在使用生产环境中的这些API之前，他们必须接受条款和条件。此外，这些营销工具还与特定网站的相关列表要求及限制相关，具体请参阅推广列表和促销管理器的“要求和限制”部分。下表列出了所有按资源分组的营销API调用。

安装和用法

要求

PHP 7.2及更高版本。

Composer

要使用Composer安装绑定，请将以下内容添加到composer.json

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github/zvps/ebay-sell-marketing-php-client.git"
    }
  ],
  "require": {
    "zvps/ebay-sell-marketing-php-client": "*@dev"
  }
}

然后运行composer install

手动安装

下载文件并包含autoload.php

<?php
require_once('/path/to/OpenAPIClient-php/vendor/autoload.php');

入门

请遵循安装过程，然后运行以下命令

<?php
require_once(__DIR__ . '/vendor/autoload.php');



// Configure OAuth2 access token for authorization: Authorization Code
$config = Ebay\Sell\Marketing\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');


$apiInstance = new Ebay\Sell\Marketing\Api\AdApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$campaign_id = 'campaign_id_example'; // string | A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling getCampaigns.
$body = new \Ebay\Sell\Marketing\Model\BulkCreateAdsByInventoryReferenceRequest(); // \Ebay\Sell\Marketing\Model\BulkCreateAdsByInventoryReferenceRequest | The container for the bulk request to create ads for eBay inventory reference IDs. eBay inventory reference IDs are seller-defined IDs used by theInventory API.

try {
    $result = $apiInstance->bulkCreateAdsByInventoryReference($campaign_id, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AdApi->bulkCreateAdsByInventoryReference: ', $e->getMessage(), PHP_EOL;
}

API端点

所有URI都是相对于https://api.ebay.com/sell/marketing/v1

模型

授权

授权代码

类型: OAuth
流程: accessCode
授权URL: https://auth.ebay.com/oauth2/authorize
作用域:
- https://api.ebay.com/oauth/api_scope/sell.marketing.readonly: 查看您的eBay营销活动，例如广告活动和列表促销
- https://api.ebay.com/oauth/api_scope/sell.marketing: 查看和管理您的eBay营销活动，例如广告活动和列表促销

客户端凭证

类型: OAuth
流程: application
授权URL: ``
作用域:
- https://api.ebay.com/oauth/api_scope: 查看来自eBay的公共数据

测试

要运行测试，请使用

composer install
vendor/bin/phpunit

作者

关于此包

此PHP包是由OpenAPI Generator项目自动生成的

API版本: v1.10.0
- 包版本: 5.0.0
构建包: org.openapitools.codegen.languages.PhpClientCodegen

zvps / ebay-sell-marketing-php-client

维护者

详细信息