SharedEntity-Datenobjekt – Kampagnenverwaltung

Artikel
11/13/2024

Definiert die Basisklasse einer freigegebenen Entität.

Versuchen Sie nicht, eine SharedEntity zu instanziieren. Sie können eines oder mehrere der folgenden Objekte erstellen, die daraus abgeleitet werden.

NegativeKeywordList, AccountNegativeKeywordList und PlacementExclusionList werden jeweils von der SharedList abgeleitet, die vom SharedEntity-Objekt abgeleitet wird.

Syntax

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

Elemente

Das SharedEntity-Objekt verfügt über die folgenden Elemente: AssociationCount, ForwardCompatibilityMap, ID, Name, Type.

Element	Beschreibung	Datentyp
AssociationCount	Die Anzahl der aktiven Zuordnungen zwischen dieser freigegebenen Entität und einer anderen Entität, z. B. einer Kampagne oder einem Anzeigenkonto. Bei negativeKeywordList beträgt die maximale Anzahl aktiver Zuordnungen zwischen der negativen Schlüsselwort (keyword) Liste und Kampagne 20. Bei einer PlacementExclusionList ist die maximale Anzahl aktiver Zuordnungen zwischen der Website-Ausschlussliste und dem Anzeigenkonto nicht definiert. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	int
ForwardCompatibilityMap	Die Liste der Schlüssel- und Wertzeichenfolgen für die Vorwärtskompatibilität, um andere Breaking Changes zu vermeiden, wenn neue Elemente in der aktuellen API-Version hinzugefügt werden. Änderungen an der Vorwärtskompatibilität werden in zukünftigen Versionen hier notiert. Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für dieses Objekt.	KeyValuePairOfstring-Array
Id	Der eindeutige Microsoft Advertising-Bezeichner der freigegebenen Entität. Hinzufügen: Schreibgeschützt Aktualisieren: Erforderlich	Lange
Name	Der Name der freigegebenen Entität. Die maximale Zeichenfolgenlänge beträgt 255. Hinzufügen: Optional Aktualisieren: Optional	Zeichenfolge
Typ	Der Typ der freigegebenen Entität. Dieser Wert ist NegativeKeywordList , wenn Sie eine NegativeKeywordList abrufen. Dieser Wert ist PlacementExclusionList , wenn Sie eine PlacementExclusionList abrufen. Dieser Wert ist AccountNegativeKeywordList , wenn Sie eine AccountNegativeKeywordList abrufen. Weitere Informationen zu freigegebenen Entitätstypen finden Sie unter Hinweise zu SharedEntity-Datenobjekten. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	Zeichenfolge

Hinweise

Legen Sie für Java und die .NET-Sprachen nicht das Type-Element fest, da der Wert vom Objekt instance bestimmt wird.

Wenn Sie das SOAP manuell generieren, verwenden Sie das type-Attribut des <SharedEntity> Knotens wie im folgenden Beispiel gezeigt, um anzugeben, ob die freigegebene Entität eine negative Schlüsselwort (keyword) Liste oder eine Websiteausschlussliste ist.

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

Anforderungen

Dienst: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Verwendet von

AddSharedEntity
DeleteSharedEntities
GetSharedEntities
GetSharedEntitiesByAccountId
UpdateSharedEntities

Freigeben über