GetAccountPilotFeatures 服务操作 - 客户管理
获取为广告帐户启用的功能试点 ID 的列表。
帐户级别试点标志仍对帐户有效,即使帐户转移到未启用试点的其他客户也是如此。 有关帐户所有权转移的详细信息,请联系你的客户经理。
如果试点 ID 未记录在下面的GetAccountPilotFeatures 参考文档中,则该功能可能是客户级别的试点功能,或者该功能已对所有帐户正式提供。
注意
大多数试点 ID 只能在客户 (经理帐户) 级别设置。 客户级试点 ID 记录在 GetCustomerPilotFeatures 操作的响应参考文档下。 仅调用 GetCustomerPilotFeatures 操作以获取客户级别的功能试点 ID。
请注意 ,GetCustomerPilotFeatures 可能还会返回帐户级别试点 ID 供内部使用;但是,对于帐户级试点,应忽略 GetCustomerPilotFeatures 的结果。
请求元素
GetAccountPilotFeaturesRequest 对象定义服务操作请求的正文和标头元素。 元素的顺序必须与 请求 SOAP 中所示的顺序相同。
注意
除非下面另有说明,否则需要所有请求元素。
请求正文元素
元素 | 说明 | 数据类型 |
---|---|---|
AccountId | 用于获取功能试点 ID 列表的帐户的标识符。 | long |
请求标头元素
元素 | 说明 | 数据类型 |
---|---|---|
AuthenticationToken | OAuth 访问令牌,表示有权Microsoft广告帐户的用户的凭据。 有关详细信息,请参阅 使用 OAuth 进行身份验证。 |
string |
DeveloperToken | 用于访问必应广告 API 的开发人员令牌。 有关详细信息,请参阅 获取开发人员令牌。 |
string |
Password | 此元素保留供内部使用,将从 API 的未来版本中删除。 必须使用 AuthenticationToken 元素来设置用户凭据。 | string |
UserName | 此元素保留供内部使用,将从 API 的未来版本中删除。 必须使用 AuthenticationToken 元素来设置用户凭据。 | string |
响应元素
GetAccountPilotFeaturesResponse 对象定义服务操作响应的正文和标头元素。 元素的返回顺序与 响应 SOAP 中所示的顺序相同。
响应正文元素
元素 | 说明 | 数据类型 |
---|---|---|
FeaturePilotFlags | 标识为广告帐户启用的功能试点的整数列表。 有关试点参与的详细信息,请联系你的客户经理。 |
int 数组 |
响应标头元素
元素 | 说明 | 数据类型 |
---|---|---|
跟踪 ID | 包含 API 调用详细信息的日志条目的标识符。 | string |
请求 SOAP
此模板由一个工具生成,用于显示 SOAP 请求的正文和标头元素的顺序。 有关可用于此服务操作的支持类型,请参阅上面的 请求正文元素 参考。
<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
<Action mustUnderstand="1">GetAccountPilotFeatures</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<GetAccountPilotFeaturesRequest xmlns="https://bingads.microsoft.com/Customer/v13">
<AccountId>ValueHere</AccountId>
</GetAccountPilotFeaturesRequest>
</s:Body>
</s:Envelope>
响应 SOAP
此模板由一个工具生成,用于显示 SOAP 响应的 正文 和 标头 元素的顺序。
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
<TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
</s:Header>
<s:Body>
<GetAccountPilotFeaturesResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<FeaturePilotFlags d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<a1:int>ValueHere</a1:int>
</FeaturePilotFlags>
</GetAccountPilotFeaturesResponse>
</s:Body>
</s:Envelope>
代码语法
示例语法可用于 必应广告 SDK。 有关更多示例,请参阅 必应广告 API 代码示例 。
public async Task<GetAccountPilotFeaturesResponse> GetAccountPilotFeaturesAsync(
long accountId)
{
var request = new GetAccountPilotFeaturesRequest
{
AccountId = accountId
};
return (await CustomerManagementService.CallAsync((s, r) => s.GetAccountPilotFeaturesAsync(r), request));
}
static GetAccountPilotFeaturesResponse getAccountPilotFeatures(
java.lang.Long accountId) throws RemoteException, Exception
{
GetAccountPilotFeaturesRequest request = new GetAccountPilotFeaturesRequest();
request.setAccountId(accountId);
return CustomerManagementService.getService().getAccountPilotFeatures(request);
}
static function GetAccountPilotFeatures(
$accountId)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new GetAccountPilotFeaturesRequest();
$request->AccountId = $accountId;
return $GLOBALS['CustomerManagementProxy']->GetService()->GetAccountPilotFeatures($request);
}
response=customermanagement_service.GetAccountPilotFeatures(
AccountId=AccountId)
要求
服务: CustomerManagementService.svc v13
命名空间: https://bingads.microsoft.com/Customer/v13
请求 URL
https://clientcenter.api.bingads.microsoft.com/CustomerManagement/v13/AccountPilotFeatures/Query
请求元素
GetAccountPilotFeaturesRequest 对象定义服务操作请求的正文和标头元素。
注意
除非下面另有说明,否则需要所有请求元素。
请求正文元素
元素 | 说明 | 数据类型 |
---|---|---|
AccountId | 用于获取功能试点 ID 列表的帐户的标识符。 | long |
请求标头元素
元素 | 说明 | 数据类型 |
---|---|---|
Authorization | OAuth 访问令牌,表示有权Microsoft广告帐户的用户的凭据。 请确保令牌的前缀为“持有者”,这是正确身份验证所必需的。 有关详细信息,请参阅 使用 OAuth 进行身份验证。 |
string |
DeveloperToken | 用于访问必应广告 API 的开发人员令牌。 有关详细信息,请参阅 获取开发人员令牌。 |
string |
Password | 此元素保留供内部使用,将从 API 的未来版本中删除。 必须使用 AuthenticationToken 元素来设置用户凭据。 | string |
UserName | 此元素保留供内部使用,将从 API 的未来版本中删除。 必须使用 AuthenticationToken 元素来设置用户凭据。 | string |
响应元素
GetAccountPilotFeaturesResponse 对象定义服务操作响应的正文和标头元素。 元素的返回顺序与 响应 JSON 中所示的顺序相同。
响应正文元素
元素 | 说明 | 数据类型 |
---|---|---|
FeaturePilotFlags | 标识为广告帐户启用的功能试点的整数列表。 有关试点参与的详细信息,请联系你的客户经理。 |
int 数组 |
响应标头元素
元素 | 说明 | 数据类型 |
---|---|---|
跟踪 ID | 包含 API 调用详细信息的日志条目的标识符。 | string |
请求 JSON
此模板由显示 JSON 请求的 正文 和 标头 元素的工具生成。 有关可用于此服务操作的支持类型,请参阅上面的 请求正文元素 参考。
{
"AccountId": "LongValueHere"
}
响应 JSON
此模板由一个工具生成,用于显示 JSON 响应的 正文 和 标头 元素。
{
"FeaturePilotFlags": [
IntValueHere
]
}
代码语法
若要通过 SDK 调用 REST API,需要将 SDK 升级到特定版本并配置系统参数。示例语法可用于 必应广告 SDK。 有关更多示例,请参阅 必应广告 API 代码示例 。
public async Task<GetAccountPilotFeaturesResponse> GetAccountPilotFeaturesAsync(
long accountId)
{
var request = new GetAccountPilotFeaturesRequest
{
AccountId = accountId
};
return (await CustomerManagementService.CallAsync((s, r) => s.GetAccountPilotFeaturesAsync(r), request));
}
static GetAccountPilotFeaturesResponse getAccountPilotFeatures(
java.lang.Long accountId) throws RemoteException, Exception
{
GetAccountPilotFeaturesRequest request = new GetAccountPilotFeaturesRequest();
request.setAccountId(accountId);
return CustomerManagementService.getService().getAccountPilotFeatures(request);
}
static function GetAccountPilotFeatures(
$accountId)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new GetAccountPilotFeaturesRequest();
$request->AccountId = $accountId;
return $GLOBALS['CustomerManagementProxy']->GetService()->GetAccountPilotFeatures($request);
}
response=customermanagement_service.GetAccountPilotFeatures(
AccountId=AccountId)