Objeto de Dados SharedEntity - Gestão de Campanhas

Artigo
07/19/2024

Define a classe base de uma entidade partilhada.

Não tente instanciar uma SharedEntity. Pode criar um ou mais dos seguintes objetos que derivam do mesmo.

NegativeKeywordList, AccountNegativeKeywordList e PlacementExclusionList são derivados da SharedList, que deriva do objeto SharedEntity.

Sintaxe

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

Elementos

O objeto SharedEntity tem os seguintes elementos: AssociationCount, ForwardCompatibilityMap, Id, Name, Type.

Elemento	Descrição	Tipo de Dados
AssociationCount	O número de associações ativas entre esta entidade partilhada e outra entidade, como a campanha ou a conta de anúncio. Para uma NegativeKeywordList, o número máximo de associações ativas entre a lista de palavras-chave negativas e a campanha é 20. Para uma PlacementExclusionList, o número máximo de associações ativas entre a lista de exclusão de sites e a conta de anúncios é indefinido. Adicionar: Só de leitura Atualização: Só de leitura	int
ForwardCompatibilityMap	A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API. As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para este objeto.	Matriz KeyValuePairOfstringstring
ID	O identificador exclusivo do Microsoft Advertising da entidade partilhada. Adicionar: Só de leitura Atualização: Necessário	long
Nome	O nome da entidade partilhada. O comprimento máximo da cadeia é 255. Adicionar: Opcional Atualização: Opcional	cadeia
Tipo	O tipo da entidade partilhada. Este valor é NegativeKeywordList quando obtém uma NegativeKeywordList. Este valor é PlacementExclusionList quando obtém uma PlacementExclusionList. Este valor é AccountNegativeKeywordList quando obtém uma AccountNegativeKeywordList. Para obter mais informações sobre os tipos de entidades partilhadas, veja SharedEntity Data Object Remarks (Comentários de Objetos de Dados da SharedEntity). Adicionar: Só de leitura Atualização: Só de leitura	cadeia

Observações

Para linguagens Java e .NET, não defina o elemento Tipo porque o valor é determinado pela instância do objeto.

Se gerar o SOAP manualmente, utilize o atributo type do <SharedEntity> nó, conforme mostrado no exemplo seguinte, para especificar se a entidade partilhada é uma lista de palavras-chave negativa ou uma lista de exclusão de sites.

<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

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13

Utilizado Por

AddSharedEntity
DeleteSharedEntities
GetSharedEntities
GetSharedEntitiesByAccountId
UpdateSharedEntities

Compartilhar via