SharedEntity データ オブジェクト - キャンペーン管理
共有エンティティの基本クラスを定義します。
SharedEntity をインスタンス化しないでください。 次のオブジェクトから派生する 1 つ以上のオブジェクトを作成できます。
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: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>
要素
SharedEntity オブジェクトには、AssociationCount、ForwardCompatibilityMap、Id、Name、Type という要素があります。
| 要素 | 説明 | データ型 |
|---|---|---|
| AssociationCount | この共有エンティティと、キャンペーンや広告アカウントなどの別のエンティティとの間のアクティブな関連付けの数。 NegativeKeywordList の場合、負のキーワード (keyword)リストとキャンペーンの間のアクティブな関連付けの最大数は 20 です。 PlacementExclusionList の場合、Web サイトの除外リストと広告アカウントの間のアクティブな関連付けの最大数は未定義です。 追加： 読み 取り 専用 更新： 読み 取り 専用 |
int |
| ForwardCompatibilityMap | 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、このオブジェクトの前方互換性の変更はありません。 |
KeyValuePairOfstring 配列 |
| Id | 共有エンティティの一意の Microsoft Advertising 識別子。 追加： 読み 取り 専用 更新： 必須 |
long |
| 名前 | 共有エンティティの名前。 文字列の最大長は 255 です。 追加： オプション 更新： オプション |
string |
| 型 | 共有エンティティの型。 NegativeKeywordList を取得する場合、この値は NegativeKeywordList です。 PlacementExclusionList を取得する場合、この値は PlacementExclusionList です。 AccountNegativeKeywordList を取得する場合、この値は AccountNegativeKeywordList です。 共有エンティティ型の詳細については、「 SharedEntity データ オブジェクトの備考」を参照してください。 追加： 読み 取り 専用 更新： 読み 取り 専用 |
string |
注釈
Java および .NET 言語の場合、値はオブジェクト インスタンスによって決定されるため、 Type 要素を設定しないでください。
SOAP を手動で生成する場合は、次の例に示すようにノードの <SharedEntity>type 属性を使用して、共有エンティティが負のキーワード (keyword)リストか 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>
要件
サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13
使用ページ
AddSharedEntity
DeleteSharedEntities
GetSharedEntities
GetSharedEntitiesByAccountId
UpdateSharedEntities