GetCustomerPilotFeatures サービス操作 - 顧客管理

[アーティクル]
10/04/2023

顧客 (マネージャーアカウント) が所有するすべての広告アカウントに対して有効になっている機能パイロット ID の一覧を取得します。

注:

パイロットフラグは、顧客の広告アカウントのサブセットに対してのみ有効にすることができます。 GetAccountPilotFeatures 操作を使用して、広告アカウントレベルの機能パイロット ID を取得します。

GetCustomerPilotFeatures は、内部使用のためにアカウントレベルのパイロット ID を返す場合もあります。ただし、アカウントレベルのパイロットの場合は、GetCustomerPilotFeatures の結果を無視する必要があります。

Request 要素

GetCustomerPilotFeaturesRequest オブジェクトは、サービス操作要求の本文とヘッダー要素を定義します。要素は、要求 SOAP に示されている順序と同じ順序である必要があります。

注:

以下に特に記載がない限り、すべての要求要素が必要です。

要求本文要素

要素	説明	データ型
Customerid	機能パイロット ID の一覧を取得するために使用される顧客の識別子。	long

要求ヘッダー要素

要素	説明	データ型
AuthenticationToken	Microsoft Advertising アカウントへのアクセス許可を持つユーザーの資格情報を表す OAuth アクセストークン。詳細については、「 OAuth による認証」を参照してください。	string
DeveloperToken	Bing Ads API へのアクセスに使用される開発者トークン。詳細については、「開発者トークンを取得する」を参照してください。	string
Password	この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。	string
UserName	この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。	string

Response 要素

GetCustomerPilotFeaturesResponse オブジェクトは、サービス操作応答の本文要素とヘッダー要素を定義します。要素は、応答 SOAP に示されている順序と同じ順序で返されます。

応答本文の要素

要素	説明	データ型
FeaturePilotFlags	顧客 (マネージャーアカウント) が所有するすべてのアカウントで有効になっている機能パイロットを識別する整数の一覧。パイロット参加の詳細については、アカウントマネージャーにお問い合わせください。たとえば、次の値は、顧客レベルの機能パイロットに対応しています。 78 - 通話追跡 268 - 動的検索広告 317 - 類似のリマーケティングリスト 351 - ローカルインベントリ広告 388 - Microsoft Audience Network 567 - 職場および学校アカウントをAzure ADする 574 - 変換に含める 579 - 顧客リストの対象ユーザー 600 - 動的検索広告テキストパート 2 616 - ビュースルー変換 618 - 複合リスト対象ユーザー 626 - マルチイメージ広告拡張機能 635 - カスタムパラメーターの制限の増加フェーズ 3 636 - 最終 URL サフィックスフェーズ 3 637 - Cookie-Based 実験 684 - ブランドショッピングキャンペーン 704 - 英国/CA/AU/DE/FR の目標広告費用対効果の入札戦略の種類 718 - スマートショッピングキャンペーン 720 - プロモーション広告拡張機能 721 - 米国の目標広告費用対効果の入札戦略の種類 734 - Google のサービスとしてのインポート 762 - ターゲットインプレッションシェアの入札戦略の種類 764 - ホテル向けサイトプロパティプロモーション広告 777 - スマートショッピングキャンペーン向けのレスポンシブ広告 793 - クライアントの代理でアカウントを作成する 802 - チラシ広告拡張機能パイロット ID の一覧には、内部で使用するアカウントレベルのパイロット ID も含まれている場合があることに注意してください。この操作によって返されるアカウントレベルのパイロット ID は無視し、代わりに GetAccountPilotFeatures 操作を使用する必要があります。	int 配列

応答ヘッダー要素

要素	説明	データ型
TrackingId	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">GetCustomerPilotFeatures</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <GetCustomerPilotFeaturesRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <CustomerId>ValueHere</CustomerId>
    </GetCustomerPilotFeaturesRequest>
  </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>
    <GetCustomerPilotFeaturesResponse 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>
    </GetCustomerPilotFeaturesResponse>
  </s:Body>
</s:Envelope>

コード構文

構文の例は、 Bing広告 SDK で使用できます。その他の例については、「Bing広告 API コードの例」を参照してください。

public async Task<GetCustomerPilotFeaturesResponse> GetCustomerPilotFeaturesAsync(
	long customerId)
{
	var request = new GetCustomerPilotFeaturesRequest
	{
		CustomerId = customerId
	};

	return (await CustomerManagementService.CallAsync((s, r) => s.GetCustomerPilotFeaturesAsync(r), request));
}

static GetCustomerPilotFeaturesResponse getCustomerPilotFeatures(
	java.lang.Long customerId) throws RemoteException, Exception
{
	GetCustomerPilotFeaturesRequest request = new GetCustomerPilotFeaturesRequest();

	request.setCustomerId(customerId);

	return CustomerManagementService.getService().getCustomerPilotFeatures(request);
}

static function GetCustomerPilotFeatures(
	$customerId)
{

	$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];

	$request = new GetCustomerPilotFeaturesRequest();

	$request->CustomerId = $customerId;

	return $GLOBALS['CustomerManagementProxy']->GetService()->GetCustomerPilotFeatures($request);
}

response=customermanagement_service.GetCustomerPilotFeatures(
	CustomerId=CustomerId)

要件

サービス: CustomerManagementService.svc v13
名前空間： https://bingads.microsoft.com/Customer/v13

次の方法で共有