共用方式為

ClientLink 資料物件 - 客戶管理

  • 發行項

定義客戶端連結物件。 接受客戶客戶客戶帳戶。 若要傳送邀請來管理用戶端廣告客戶帳戶，請呼叫 AddClientLinks 作業，並針對每個要管理的帳戶指定一個客戶端連結。

用戶端連結沒有公用系統標識碼。 您可以透過 ClientEntityId 和 ManagingCustomerId 來識別不同的客戶端連結。

提示

如需客戶端連結生命週期的詳細資訊，請參閱 帳戶階層 技術指南。 如需成為機構的詳細資訊，請參閱 機構合作夥伴的資源。 如需客戶端觀點的詳細資訊，請參閱 如何讓機構管理您的 Microsoft Advertising 帳戶。

注意事項

代理者客戶在代表用戶端建立帳戶試驗中 (GetCustomerPilotFeatures 會傳回 793) 也可以透過 SignupCustomer 服務作業建立廣告帳戶層級客戶端連結。 如需詳細資訊，請參閱 SignupCustomer 。

語法

<xs:complexType name="ClientLink" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ClientEntityNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ManagingCustomerNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Note" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterPhone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsBillToClient" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ClientLinkStatus" />
    <xs:element minOccurs="0" name="SuppressNotification" type="xs:boolean" />
    <xs:element minOccurs="0" name="LastModifiedDateTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" type="xs:long" />
    <xs:element minOccurs="0" name="Timestamp" nillable="true" type="xs:base64Binary" />
    <xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

元素

ClientLink 物件具有下列元素：ClientEntityId、ClientEntityName、ClientEntityNumber、CustomerLinkPermission、ForwardCompatibilityMap、InviterEmail、InviterName、InviterPhone、IsBillToClient、LastModifiedByUserId、LastModifiedDateTime、ManagingCustomerId、ManagingCustomerName、ManagingCustomerNumber、Name、Note、StartDate、Status、SuppressNotification、Timestamp、Type。

元素 描述 資料類型
ClientEntityId 要管理的用戶端廣告客戶帳戶或客戶客戶的識別碼

Type 元素會判斷連結是客戶客戶帳戶還是客戶客戶。

加： 必填。 需要 ClientEntityId 或 ClientEntityNumber ，但同時指定這兩者會導致作業失敗。
更新： 唯讀和必要。		 長
ClientEntityName 要管理的用戶端廣告客戶帳戶或客戶客戶的名稱

Type 元素會判斷連結是客戶客戶帳戶還是客戶客戶。

加： 唯讀
更新： 唯讀		 string
ClientEntityNumber 要管理的用戶端廣告客戶帳戶或客戶客戶數目

Type 元素會判斷連結是客戶客戶帳戶還是客戶客戶。

加： 必填。 需要 ClientEntityId 或 ClientEntityNumber ，但同時指定這兩者會導致作業失敗。
更新： 唯讀和必要。		 string
CustomerLinkPermission 判斷使用者對帳戶的存取是否受客戶階層限制，也就是客戶層級客戶端連結。

只有在 Type 設定為 CustomerLink 時，才適用此元素。 在此情況下，可能的值包括 [系統管理] 和 [Standard]。 否則，此欄位應該是 nil 或空白。

如果此欄位設定為 [系統管理]，則使用者可以透過 [系統管理客戶] 連結存取 ClientEntityId。

如果此欄位設定為 「Standard」，使用者可以透過 Standard 客戶連結存取 ClientEntityId。

ClientEntityId 是客戶鏈接階層的一部分，使用者可以存取其下方的其他客戶。

如需詳細資訊，請參閱 使用者角色 技術指南。

加： 自選
更新： 唯讀		 string
ForwardCompatibilityMap 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。

未來的版本中將會記下向前相容性變更。 ClientLink 物件目前沒有向前相容性變更。		 KeyValuePairOfstringstring 陣 列
InviterEmail 建立客戶端連結要求之用戶的電子郵件。

此值不需要與目前已驗證的用戶儲存在 Microsoft Advertising 中的電子郵件相同，也不需要用來修改。

如果未指定，服務會將此值設定為目前已驗證使用者的 Microsoft Advertising 中已儲存的電子郵件。

加： 自選
更新： 唯讀		 string
InviterName 建立客戶端連結要求之使用者的父客戶名稱。

此值不需要與已儲存在 Microsoft Advertising 中的客戶名稱相同，也不需要用來修改。

如果未指定，服務會將此值設定為目前已驗證使用者的 Microsoft Advertising 中已儲存的父客戶名稱。

加： 自選
更新： 唯讀		 string
InviterPhone 建立客戶端連結要求之用戶的電話號碼。

此值不需要與目前已驗證的用戶儲存在 Microsoft Advertising 中的電話號碼相同，也不需要用來修改電話號碼。

如果未指定，服務會將此值設定為目前已驗證使用者Microsoft Advertising 中已儲存的電話號碼。

加： 自選
更新： 唯讀		 string
IsBillToClient 判斷客戶客戶帳戶的擁有者或管理客戶是否負責帳單付款。

此元素僅適用於廣告用戶端連結，不適用於客戶連結。 用戶端廣告客戶帳戶必須設定為支付後帳單。 機構不支援預付帳戶進行管理。 如果設定為 true，用戶端會負責計費。 如果設定為 false，則管理的客戶會負責計費。

加： 廣告客戶連結的必要專案;不適用於客戶連結。
更新： 唯讀		 布爾
LastModifiedByUserId 要更新用戶端連結資訊之最後一個使用者的標識碼。

加： 唯讀
更新： 唯讀		 長
LastModifiedDateTime 上次更新客戶端連結的日期和時間。 值為國際標準時間 (UTC)。

日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。

加： 唯讀
更新： 唯讀		 dateTime
ManagingCustomerId 管理或要求管理客戶客戶帳戶的客戶標識碼。

加： 必填。 需要 ManagingCustomerId 或 ManagingCustomerNumber ，但同時指定這兩者會導致作業失敗。
更新： 唯讀和必要		 長
ManagingCustomerName 管理或要求管理客戶帳戶的客戶名稱。

加： 唯讀
更新： 唯讀		 string
ManagingCustomerNumber 管理或要求管理客戶客戶帳戶的客戶數目。

加： 必填。 需要 ManagingCustomerId 或 ManagingCustomerNumber ，但同時指定這兩者會導致作業失敗。
更新： 唯讀和必要		 string
名稱 可用來參考此用戶端連結的易記名稱。

名稱最多可以包含 40 個字元。

如果未指定任何名稱，則會提供預設名稱。 相較於使用者的其他用戶端連結，名稱不需要是唯一的。

加： 自選
更新： 唯讀		 string
注意事項 來自要求者的選擇性訊息，提供有關用戶端連結邀請的內容和詳細數據。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 string
StartDate 狀態更新的日期。 對於已接受的連結要求，狀態會在此日期轉換為 [作用中]，而對於取消連結要求，狀態會在此日期轉換為 [非作用中]。

如果未指定，此值會設定為目前的日期和時間。

加： 自選
更新： 唯讀		 dateTime
地位 判斷客戶端連結的生命周期狀態，例如是否已接受或拒絕客戶端連結。

新增客戶端連結時，無法指定此元素，而且服務會將有效狀態設定為LinkPending。

加： 唯讀
更新： 必填		 ClientLinkStatus
SuppressNotification 判斷是否要傳送用戶端連結邀請的電子郵件通知給用戶端用戶端帳戶的主要使用者。

如果設定為 true，用戶端將不會收到電子郵件，否則，因為預設值為 false，用戶端會收到電子郵件通知。

加： 自選
更新： 唯讀		 布爾
時間戳記 保留供日後使用。 base64Binary
類型 判斷連結是客戶客戶帳戶還是客戶客戶客戶。

可能的值為 AccountLink 和 CustomerLink。 如果這個專案是空的或設定為 AccountLink，ClientEntityId、 ClientEntityName 和 ClientEntityNumber 代表用戶端廣告客戶帳戶。 如果此元素設定為 CustomerLink，ClientEntityId、 ClientEntityName 和 ClientEntityNumber 代表客戶端客戶。

加： 自選。 如果未設定此元素，服務會嘗試建立廣告客戶端連結。
更新： 唯讀		 string

需求

服務： CustomerManagementService.svc v13
Namespace： https://bingads.microsoft.com/Customer/v13/Entities

消費者

AddClientLinks
SearchClientLinks
UpdateClientLinks