通过

SharedEntity 数据对象 - 市场活动管理

  • 项目

定义共享实体的基类。

不要尝试实例化 SharedEntity。 可以创建派生自它的一个或多个以下对象。

NegativeKeywordList、AccountNegativeKeywordList 和 PlacementExclusionList 分别派生自 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:q93="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q93: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，负关键字 (keyword) 列表与市场活动之间的活动关联的最大数目为 20。 对于 PlacementExclusionList，未定义网站排除列表和广告帐户之间的活动关联的最大数目。

添加： 只读
更新： 只读		 int
ForwardCompatibilityMap 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。

将来的版本中将在此处记录向前兼容性更改。 此对象当前没有向前兼容性更改。		 KeyValuePairOfstringstring 数组
Id 共享实体的唯一 Microsoft Advertising 标识符。

添加： 只读
更新： 必填		 long
名称 共享实体的名称。

最大字符串长度为 255。

添加： 选
更新： 选		 string
类型 共享实体的类型。

检索 NegativeKeywordList 时，此值为 NegativeKeywordList。 检索 PlacementExclusionList 时，此值为 PlacementExclusionList。 检索 AccountNegativeKeywordList 时，此值为 AccountNegativeKeywordList。

有关共享实体类型的详细信息，请参阅 SharedEntity 数据对象备注。

添加： 只读
更新： 只读		 string

备注

对于 Java 和 .NET 语言，请勿设置 Type 元素，因为值由对象实例确定。

如果手动生成 SOAP，请使用节点的 <SharedEntity>type 属性，如以下示例所示，指定共享实体是负关键字 (keyword) 列表还是网站排除列表。

<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