PHP 与必应广告 API 协同运用的入门指南

本文要点

若打算开启 PHP 对必应广告 API 应用程序的开发，可以从所提供的示例起步，或者依照 Web 或桌面应用程序的应用程序演练操作。这些示例借助必应广告 PHP SDK 开发而成，并在 PHP 7.0.6 环境下运行。您能够运用其他版本的 PHP（大于 5.6）、包以及操作系统。不过，可能需要对部分代码和配置做出调整。关于如何搭建 PHP 开发环境以使用 Web 服务的相关信息，请查阅工具的文档。同时，应当在 PHP.ini 文件中启用 SOAP 和扩展。为运行批量上传示例，还需启用 curl 扩展。

extension=php_soap.dllextension=php_openssl.dllextension=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 服务地址

处理服务错误和异常

沙盒