AdExtension データ オブジェクト - キャンペーン管理

広告拡張機能の基本オブジェクトを定義します。

AdExtension をインスタンス化しないでください。 次のオブジェクトから派生する 1 つ以上のオブジェクトを作成できます。

• ActionAdExtension
• AppAdExtension
• CallAdExtension
• CalloutAdExtension
• FilterLinkAdExtension
• FlyerAdExtension
• ImageAdExtension
• LocationAdExtension
• LogoAdExtension
• PriceAdExtension
• PromotionAdExtension
• ReviewAdExtension
• SitelinkAdExtension
• StructuredSnippetAdExtension

構文

<xs:complexType name="AdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element xmlns:q42="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q42:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Scheduling" nillable="true" type="tns:Schedule" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdExtensionStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Version" nillable="true" type="xs:int" />
  </xs:sequence>
</xs:complexType>

要素

AdExtension オブジェクトには、DevicePreference、ForwardCompatibilityMap、Id、Scheduling、Status、Type、Version の各要素があります。

要素	説明	データ型
DevicePreference	この要素は、広告拡張機能をモバイル デバイスに表示するか、すべてのデバイスに表示するかを決定します。 モバイル デバイスの基本設定を指定するには、この要素を 30001 に設定します。 すべてのデバイスを指定するには、この要素を 0 (ゼロ) に設定するか、要素 nil のままにします。 既定では、この要素は nil になります。 この要素は、 AppAdExtension 型と SitelinkAdExtension 型にのみ適用されます。	long
ForwardCompatibilityMap	現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、このオブジェクトの前方互換性の変更はありません。	KeyValuePairOfstring 配列
Id	広告拡張機能の一意の Microsoft Advertising 識別子。	long
スケジュール設定	広告表示オプションが広告に表示される資格があるカレンダーの曜日と時刻の範囲を決定します。	Schedule
Status	広告拡張機能の状態。 キャンペーン管理サービスでは削除された広告表示オプションが返されないため、値は常に アクティブ になります。	AdExtensionStatus
種類	広告拡張機能の種類。 詳細については、「解説」を参照してください。	string
バージョン	広告拡張機能が更新された回数を追跡します。 バージョンは、広告拡張機能の作成時に 1 に設定され、更新のたびに 1 ずつインクリメントされます。	int

注釈

SOAP を手動で生成する場合は、次の例に示すように、ノードの <AdExtension>type 属性を使用して広告拡張機能の種類を指定します。

<AdExtension i:type="ReviewAdExtension" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id i:nil="true" />
    <Status i:nil="true" />
      . . .
</AdExtension>

要件

サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

使用ページ

AddAdExtensions
AdExtensionAssociation
GetAdExtensionsByIds
UpdateAdExtensions