AddClientLinks サービス操作 - Customer Management

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

別の顧客のアカウントを管理するためのクライアントリンクプロセスを開始します。ある顧客から別の顧客またはアカウントにリンク要求を送信します。

注:

スーパー管理者または標準の資格情報を持つユーザーのみが、広告主アカウントへのクライアントリンクを追加、更新、検索できます。 Super Admin 資格情報を持つユーザーのみが、顧客へのクライアントリンクを追加、更新、検索できます。詳細については、ユーザーロールのテクニカルガイドを参照してください。

代理店にリンクできるクライアントアカウントの量に制限はありません。クライアントアカウントには、支払後請求用に有効な支払い方法が設定されている必要があります。前払いアカウントは、代理店による管理ではサポートされていません。

ヒント

クライアントリンクライフサイクルの詳細については、アカウント階層のテクニカルガイドを参照してください。代理店になる方法の詳細については、代理店パートナー向けのリソースに関するページを参照してください。クライアントの観点から詳しくは、「 Microsoft Advertising アカウントを代理店で管理する方法」をご覧ください。

注:

クライアントの代理でアカウントを作成するパイロット (GetCustomerPilotFeatures が 793 を返す) の代理店のお客様は、 SignupCustomer サービス操作を介して広告アカウントレベルのクライアントリンクを確立することもできます。詳細については、「 SignupCustomer 」を参照してください。

Request 要素

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

注:

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

要求本文要素

要素	説明	データ型
ClientLinks	追加するクライアントリンクの一覧。要求は、呼び出しごとに 10 個のクライアントリンクに制限する必要があります。	ClientLink 配列

要求ヘッダー要素

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

Response 要素

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

応答本文の要素

要素	説明	データ型
OperationErrors	サービス操作が失敗し、クライアントリンクが追加されなかった 1 つ以上の理由の一覧。	OperationError 配列
PartialErrors	正常に追加されなかったクライアントリンクの詳細を含む OperationError リストの配列。結果は、要求されたクライアントリンクに対応する同じ順序で返されます。最初のディメンションリスト要素の数は、要求されたクライアントリンク数と等しくなります。クライアントリンクが正常に追加された場合、対応するインデックスの OperationError 要素は null です。	OperationError 配列

応答ヘッダー要素

要素	説明	データ型
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">AddClientLinks</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <AddClientLinksRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <ClientLinks xmlns:e221="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e221:ClientLink>
          <e221:Type i:nil="false">ValueHere</e221:Type>
          <e221:ClientEntityId i:nil="false">ValueHere</e221:ClientEntityId>
          <e221:ClientEntityNumber i:nil="false">ValueHere</e221:ClientEntityNumber>
          <e221:ClientEntityName i:nil="false">ValueHere</e221:ClientEntityName>
          <e221:ManagingCustomerId i:nil="false">ValueHere</e221:ManagingCustomerId>
          <e221:ManagingCustomerNumber i:nil="false">ValueHere</e221:ManagingCustomerNumber>
          <e221:ManagingCustomerName i:nil="false">ValueHere</e221:ManagingCustomerName>
          <e221:Note i:nil="false">ValueHere</e221:Note>
          <e221:Name i:nil="false">ValueHere</e221:Name>
          <e221:InviterEmail i:nil="false">ValueHere</e221:InviterEmail>
          <e221:InviterName i:nil="false">ValueHere</e221:InviterName>
          <e221:InviterPhone i:nil="false">ValueHere</e221:InviterPhone>
          <e221:IsBillToClient i:nil="false">ValueHere</e221:IsBillToClient>
          <e221:StartDate i:nil="false">ValueHere</e221:StartDate>
          <e221:Status i:nil="false">ValueHere</e221:Status>
          <e221:SuppressNotification>ValueHere</e221:SuppressNotification>
          <e221:LastModifiedDateTime>ValueHere</e221:LastModifiedDateTime>
          <e221:LastModifiedByUserId>ValueHere</e221:LastModifiedByUserId>
          <e221:Timestamp i:nil="false">ValueHere</e221:Timestamp>
          <e221:ForwardCompatibilityMap xmlns:e222="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
            <e222:KeyValuePairOfstringstring>
              <e222:key i:nil="false">ValueHere</e222:key>
              <e222:value i:nil="false">ValueHere</e222:value>
            </e222:KeyValuePairOfstringstring>
          </e221:ForwardCompatibilityMap>
          <e221:CustomerLinkPermission i:nil="false">ValueHere</e221:CustomerLinkPermission>
        </e221:ClientLink>
      </ClientLinks>
    </AddClientLinksRequest>
  </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>
    <AddClientLinksResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <OperationErrors xmlns:e223="https://bingads.microsoft.com/Customer/v13/Exception" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <e223:OperationError>
          <e223:Code>ValueHere</e223:Code>
          <e223:Details d4p1:nil="false">ValueHere</e223:Details>
          <e223:Message d4p1:nil="false">ValueHere</e223:Message>
        </e223:OperationError>
      </OperationErrors>
      <PartialErrors xmlns:e224="https://bingads.microsoft.com/Customer/v13/Exception" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <e224:ArrayOfOperationError>
          <e224:OperationError>
            <e224:Code>ValueHere</e224:Code>
            <e224:Details d4p1:nil="false">ValueHere</e224:Details>
            <e224:Message d4p1:nil="false">ValueHere</e224:Message>
          </e224:OperationError>
        </e224:ArrayOfOperationError>
      </PartialErrors>
    </AddClientLinksResponse>
  </s:Body>
</s:Envelope>

コード構文

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

public async Task<AddClientLinksResponse> AddClientLinksAsync(
	IList<ClientLink> clientLinks)
{
	var request = new AddClientLinksRequest
	{
		ClientLinks = clientLinks
	};

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

static AddClientLinksResponse addClientLinks(
	ArrayOfClientLink clientLinks) throws RemoteException, Exception
{
	AddClientLinksRequest request = new AddClientLinksRequest();

	request.setClientLinks(clientLinks);

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

static function AddClientLinks(
	$clientLinks)
{

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

	$request = new AddClientLinksRequest();

	$request->ClientLinks = $clientLinks;

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

response=customermanagement_service.AddClientLinks(
	ClientLinks=ClientLinks)

要件

サービス: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13

次の方法で共有