Objet de données SharedEntity - Gestion des campagnes

Article
07/19/2024

Définit la classe de base d’une entité partagée.

N’essayez pas d’instancier un SharedEntity. Vous pouvez créer un ou plusieurs des objets suivants qui en dérivent.

NegativeKeywordList, AccountNegativeKeywordList et PlacementExclusionList sont chacun dérivés de SharedList, qui dérive de l’objet SharedEntity.

Syntaxe

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

Éléments

L’objet SharedEntity contient les éléments suivants : AssociationCount, ForwardCompatibilityMap, Id, Name, Type.

Élément	Description	Type de données
AssociationCount	Nombre d’associations actives entre cette entité partagée et une autre entité telle que la campagne ou le compte publicitaire. Pour un NegativeKeywordList, le nombre maximal d’associations actives entre la liste de mot clé négatives et la campagne est de 20. Pour un PlacementExclusionList, le nombre maximal d’associations actives entre la liste d’exclusion de site web et le compte publicitaire n’est pas défini. Ajouter: En lecture seule Mettre à jour: En lecture seule	int
ForwardCompatibilityMap	Liste des chaînes de clé et de valeur pour la compatibilité avant afin d’éviter les changements cassants lorsque de nouveaux éléments sont ajoutés dans la version actuelle de l’API. Les modifications de compatibilité avant seront notées ici dans les versions ultérieures. Il n’existe actuellement aucune modification de compatibilité avant pour cet objet.	Tableau KeyValuePairOfstringstring
ID	Identificateur Microsoft Advertising unique de l’entité partagée. Ajouter: En lecture seule Mettre à jour: Obligatoire	Long
Nom	Nom de l’entité partagée. La longueur maximale de la chaîne est de 255. Ajouter: Optionnel Mettre à jour: Optionnel	chaîne
Type	Type de l’entité partagée. Cette valeur est NegativeKeywordList lorsque vous récupérez un NegativeKeywordList. Cette valeur est PlacementExclusionList lorsque vous récupérez un PlacementExclusionList. Cette valeur est AccountNegativeKeywordList lorsque vous récupérez un AccountNegativeKeywordList. Pour plus d’informations sur les types d’entités partagées, consultez Notes sur l’objet de données SharedEntity. Ajouter: En lecture seule Mettre à jour: En lecture seule	chaîne

Remarques

Pour Java et les langages .NET, ne définissez pas l’élément Type, car la valeur est déterminée par l’objet instance.

Si vous générez manuellement le soap, utilisez l’attribut type du <SharedEntity> nœud, comme indiqué dans l’exemple suivant, pour spécifier si l’entité partagée est une liste de mot clé négative ou une liste d’exclusion de site 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>

Configuration requise

Service : CampaignManagementService.svc v13
Noms: https://bingads.microsoft.com/CampaignManagement/v13

Utilisé par

AddSharedEntity
DeleteSharedEntities
GetSharedEntities
GetSharedEntitiesByAccountId
UpdateSharedEntities

Partager via