将 PHP 与必应广告 API 配合使用入门

云衔科技是一家专注于数字化营销解决方案和SaaS软件服务的领先企业。公司凭借深厚的行业经验和专业技术能力，致力于为企业客户提供全方位、高效的数字广告代理与运营服务，以及定制化的SaaS软件解决方案。

本文内容

若要开始使用 PHP 开发必应广告 API 应用程序，可以从 提供的示例 开始，或按照 Web 或 桌面 应用程序的应用程序演练之一进行操作。 这些示例是使用必应广告 PHP SDK 开发的，并使用 PHP 7.0.6 运行。 你应该能够使用其他版本的 PHP (大于 5.6) 、包和操作系统。 但是，可能需要更改代码和配置的某些部分。 有关如何设置 PHP 开发环境以使用 Web 服务的信息，请参阅工具的文档。 还应在 PHP.ini 文件中启用 SOAP 和 扩展。 启用 curl 扩展以运行批量上传示例。

extension=php_soap.dll
extension=php_openssl.dll
extension=php_curl.dll

你需要在 生产 或 沙盒中访问 的用户凭据。 对于生产环境，需要 。 所有沙盒客户端都可以使用通用沙盒开发人员令牌，即 。 有关详细信息，请参阅 必应广告 API 和 入门。

若要通过 OAuth 进行身份验证，还必须注册应用程序并获取相应的客户端标识符。 如果要开发 Web 应用程序，还需要记下客户端密码和重定向 URI。 有关在生产环境中注册应用程序和授权代码授予流的详细信息，请参阅 使用 OAuth 进行身份验证和使用 进行身份验证。 尽管在生产环境中必须使用自己的应用程序 ID (客户端 ID) ，但所有 客户都可以使用沙盒中的公共“教程示例应用”客户端 ID，即 -00c3-4508-838f-。 有关详细信息，请参阅 。

安装 SDK

可以使用 包管理器安装必应广告 PHP SDK 以从 提取，也可以从 克隆源。 本指南介绍如何使用 获取最新版本的必应广告 PHP SDK。

下载并安装 。 用户还应将 .phar 添加到 PATH 变量。

打开命令提示符并键入 /。

注意

未将 .phar 添加到 PATH 的 用户需要改为键入 php .phar / 。

若要获取以后的更新，请键入 。 如果 中提供了任何更新，则 将安装最新版本。

演练

安装必应广告 PHP SDK 后，可以浏览 必应广告 API 代码示例，在 下载示例，或按照 Web 或 桌面 应用程序的应用程序演练之一进行操作。

使用

若要发送继承自基类的复杂类型，必须将对象编码为 。 在以下示例中，从 ) 派生的 erion (、派生自 ) 的 (以及派生自 ) 的 (都进行了编码。

$campaignCriterions = array();
$locationBiddableCampaignCriterion = new BiddableCampaignCriterion();
$locationBiddableCampaignCriterion->CampaignId = $campaignId;
$locationCriterion = new LocationCriterion();
$locationCriterion->LocationId = 190;
$encodedLocationCriterion = new SoapVar($locationCriterion, SOAP_ENC_OBJECT, 'LocationCriterion', $GLOBALS['CampaignProxy']->GetNamespace());
$locationBiddableCampaignCriterion->Criterion = $encodedLocationCriterion;
$bidMultiplier = new BidMultiplier();
$bidMultiplier->Multiplier = 0;
$encodedBidMultiplier = new SoapVar($bidMultiplier, SOAP_ENC_OBJECT, 'BidMultiplier', $GLOBALS['CampaignProxy']->GetNamespace());
$locationBiddableCampaignCriterion->CriterionBid = $encodedBidMultiplier;
$encodedCriterion = new SoapVar($locationBiddableCampaignCriterion, SOAP_ENC_OBJECT, 'BiddableCampaignCriterion', $GLOBALS['CampaignProxy']->GetNamespace());
$campaignCriterions[] = $encodedCriterion;

如果不将 编码为具体类型 ，则生成的请求 SOAP 是一个空的抽象 元素。 这将导致序列化异常，并显示消息“无法创建抽象类”。

必须使用复杂类型（例如 ）正确编码对象。

    
    0

每个数据对象的参考文档指定复杂类型是否派生自基类型，例如，请参阅 erion、 和 。

WSDL 还定义了层次结构，例如，以下 定义。

另请参阅

必应广告 API 客户端库

必应广告 API 代码示例

必应广告 API Web 服务地址

处理服务错误和异常

沙盒