Objeto de datos SharedEntity: Administración de campañas

Artículo
11/13/2024

Define la clase base de una entidad compartida.

No intente crear una instancia de SharedEntity. Puede crear uno o varios de los siguientes objetos que se derivan de él.

NegativeKeywordList, AccountNegativeKeywordList y PlacementExclusionList se derivan de SharedList, que deriva del objeto SharedEntity.

Sintaxis

<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>

Elementos

El objeto SharedEntity tiene los siguientes elementos: AssociationCount, ForwardCompatibilityMap, Id, Name, Type.

Elemento	Descripción	Tipo de datos
AssociationCount	Número de asociaciones activas entre esta entidad compartida y otra entidad, como una campaña o una cuenta publicitaria. En el caso de NegativeKeywordList, el número máximo de asociaciones activas entre la lista de palabras clave negativas y la campaña es 20. En el caso de PlacementExclusionList, el número máximo de asociaciones activas entre la lista de exclusión del sitio web y la cuenta de anuncios no está definido. Añadir: Solo lectura Actualizar: Solo lectura	int
ForwardCompatibilityMap	Lista de cadenas de clave y valor para la compatibilidad con reenvíos para evitar cambios importantes en caso contrario cuando se agregan nuevos elementos en la versión actual de la API. Los cambios de compatibilidad de reenvío se anotarán aquí en futuras versiones. Actualmente no hay cambios de compatibilidad de reenvío para este objeto.	Matriz KeyValuePairOfstringstring
Id	Identificador único de Microsoft Advertising de la entidad compartida. Añadir: Solo lectura Actualizar: Obligatorio	Largo
Nombre	Nombre de la entidad compartida. La longitud máxima de la cadena es 255. Añadir: Opcional Actualizar: Opcional	string
Tipo	Tipo de la entidad compartida. Este valor es NegativeKeywordList cuando se recupera negativeKeywordList. Este valor es PlacementExclusionList cuando se recupera un objeto PlacementExclusionList. Este valor es AccountNegativeKeywordList cuando se recupera un AccountNegativeKeywordList. Para obtener más información sobre los tipos de entidades compartidas, vea Comentarios de objetos de datos SharedEntity. Añadir: Solo lectura Actualizar: Solo lectura	string

Observaciones

Para Java y los lenguajes .NET, no establezca el elemento Type porque el valor viene determinado por la instancia del objeto.

Si genera soap manualmente, use el atributo type del <SharedEntity> nodo, como se muestra en el ejemplo siguiente, para especificar si la entidad compartida es una lista de palabras clave negativas o una lista de exclusión de sitios web.

<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>

Requisitos

Servicio: CampaignManagementService.svc v13
Nombres: https://bingads.microsoft.com/CampaignManagement/v13

Usado por

AddSharedEntity
DeleteSharedEntities
GetSharedEntities
GetSharedEntitiesByAccountId
UpdateSharedEntities

Compartir a través de