広告グループプロモーション広告拡張機能レコード - 一括
一括ファイルでアップロードおよびダウンロードできる 広告グループ と プロモーション広告拡張機能 の間の関連付けレコードを定義します。 広告グループまたはプロモーション広告拡張機能をアップロードまたはダウンロードするには、 広告グループ または プロモーション広告拡張機能 レコードを使用します。
注:
プロモーション拡張機能は、機能パイロットのお客様が利用できます (GetCustomerPilotFeatures は 720 を返します)。
AdGroupPromotionAdExtensions の DownloadEntity 値を DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に含めることで、アカウント内のすべての広告グループプロモーション広告拡張機能レコードをダウンロードできます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。
次の一括 CSV の例では、有効な ID と親 ID の値が指定されている場合、プロモーション広告拡張機能を広告グループに関連付けます。
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Ad Group Promotion Ad Extension,Active,-11,-1111,,,ClientIdGoesHere,,
.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して BulkAdGroupPromotionAdExtension オブジェクトをアップロードしてダウンロードする時間を節約できます。サービス操作を直接呼び出し、カスタム コードを記述してバルク ファイル内の各フィールドを解析する代わりにします。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAdGroupPromotionAdExtension
var bulkAdGroupPromotionAdExtension = new BulkAdGroupPromotionAdExtension
{
// Map properties in the Bulk file to the
// AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
{
// 'Id' column header in the Bulk file
AdExtensionId = promotionAdExtensionIdKey,
// 'Parent Id' column header in the Bulk file
EntityId = adGroupIdKey,
},
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
};
uploadEntities.Add(bulkAdGroupPromotionAdExtension);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
広告グループプロモーション広告拡張機能レコードの場合、一括ファイル スキーマでは、次の属性フィールドを使用できます。
広告グループ
この広告拡張機能が関連付けられている、または削除される広告グループの名前。
追加： 読み取り専用と必須
削除： 読み取り専用と必須
キャンペーン
この広告拡張機能が関連付けられている、または削除される広告グループを含むキャンペーンの名前。
追加： 読み 取り 専用
削除： 読み 取り 専用
クライアント ID
一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。
追加： オプション
削除： 読み 取り 専用
編集場所
編集レビューに失敗した広告拡張機能のコンポーネントまたはプロパティ。
追加： 読み 取り 専用
削除： 読み 取り 専用
編集理由コード
エラーの理由を識別するコード。 考えられる理由コードの一覧については、「 編集理由コード」を参照してください。
追加： 読み 取り 専用
削除： 読み 取り 専用
編集状態
広告拡張機能の編集状態。
使用可能な値については、次の表を参照してください。
追加： 読み 取り 専用
削除： 読み 取り 専用
編集用語
編集レビューに失敗した用語。
用語の組み合わせによってエラーが発生した場合、またはポリシー違反に基づいて失敗した場合、このフィールドは設定されません。
追加： 読み 取り 専用
削除： 読み 取り 専用
Id
広告グループに関連付けられている、または広告グループから削除される広告拡張機能の識別子。
この一括フィールドは、プロモーション広告拡張機能レコードの Id フィールドにマップされます。
追加： 読み取り専用と必須。 既存の広告拡張機能識別子を指定するか、親のプロモーション広告拡張機能レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイルに新しい広告表示オプションと関連付けを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
削除： 読み取り専用と必須
変更時刻
エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。
注:
日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
追加： 読み 取り 専用
削除： 読み 取り 専用
Parent Id
この広告拡張機能が関連付けられている、または削除される広告グループの識別子。
この一括フィールドは、広告グループ レコードの Id フィールドにマップされます。
追加： 読み取り専用と必須。 既存の広告グループ識別子を指定するか、親広告グループ レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内の新しい広告グループに広告拡張子を関連付ける場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
削除： 読み取り専用と必須
発行元の国
編集ガイドラインで指定した 用語が許可されていない発行元の国または地域の一覧。
一括ファイルでは、発行元の国またはリージョンの一覧はセミコロン (;)で区切られます。
追加： 読み 取り 専用
削除： 読み 取り 専用
状態
広告グループと広告拡張機能の間の関連付けの状態を表します。
有効な値は [アクティブ] と [削除済み] です。 広告拡張機能が広告グループに関連付けられている場合、このフィールドの値は [アクティブ] になります。
追加： 読み 取り 専用
削除： 必須。 [状態] を [削除済み] に設定する必要があります。