SharedEntity 數據物件 - 營銷活動管理

定義共用實體的基類。

請勿嘗試具現化 SharedEntity。 您可以建立一或多個衍生自它的下列物件。

• NegativeKeywordList
• PlacementExclusionList
• AccountNegativeKeywordList

NegativeKeywordList、AccountNegativeKeywordList 和 PlacementExclusionList 都是衍生自 SharedList，而 SharedList 衍生自 SharedEntity 物件。

語法

<xs:complexType name="SharedEntity" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AssociationCount" nillable="true" type="xs:int" />
    <xs:element xmlns:q92="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q92:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

元素

SharedEntity 物件具有下列元素：AssociationCount、ForwardCompatibilityMap、Id、Name、Type。

元素	說明	資料類型
AssociationCount	此共用實體與另一個實體之間的作用中關聯數目，例如營銷活動或廣告帳戶。 針對 NegativeKeywordList，負關鍵詞列表與行銷活動之間的作用中關聯數目上限為 20。 對於 PlacementExclusionList，網站排除清單與廣告帳戶之間的作用中關聯數目上限是未定義的。 添加： 唯讀 更新： 唯讀	int
ForwardCompatibilityMap	用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。 未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。	KeyValuePairOfstringstring 陣 列
識別碼	共享實體的唯一 Microsoft Advertising 識別碼。 添加： 唯讀 更新： 必填	長
名稱	共用實體的名稱。 字串長度上限為 255。 添加： 選 更新： 選	string
類型	共用實體的類型。 當您擷取 NegativeKeywordList 時，此值為 NegativeKeywordList。 當您擷取 PlacementExclusionList 時，此值為 PlacementExclusionList。 當您擷取 AccountNegativeKeywordList 時，此值為 AccountNegativeKeywordList。 如需共用實體類型的詳細資訊，請參閱 SharedEntity 資料物件備註。 添加： 唯讀 更新： 唯讀	string

註解

針對 Java 和 .NET 語言，請勿設定 Type 元素，因為值是由物件實例所決定。

如果您手動產生 SOAP，請使用節點的<SharedEntity>類型屬性，如下列範例所示，指定共用實體是負關鍵詞清單還是網站排除清單。

<SharedEntity i:type="NegativeKeywordList" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <AssociationCount i:nil="true" />
  <ForwardCompatibilityMap i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic" />
  <Id i:nil="true" />
  <Name>My Negative Keyword List</Name>
  <ItemCount i:nil="true" />
</SharedEntity>

需求

服務： CampaignManagementService.svc v13
命名空間： https://bingads.microsoft.com/CampaignManagement/v13

消費者

AddSharedEntity
DeleteSharedEntities
GetSharedEntities
GetSharedEntitiesByAccountId
UpdateSharedEntities