広告グループ ラベル レコード - 一括

一括ファイルでアップロードおよびダウンロードできる 広告グループ と ラベル の間の関連付けレコードを定義します。 広告グループまたはラベルをアップロードまたはダウンロードするには、 広告グループ または ラベル レコードを使用します。

AdGroupLabels の DownloadEntity 値を DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に含めることで、アカウント内のすべての広告グループ ラベル レコードをダウンロードできます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。

次の一括 CSV の例では、有効な ID と親 ID の 値が指定されている場合に、広告グループにラベル を 適用します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Ad Group Label,,-22,-1111,,,ClientIdGoesHere,,,,,

.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して BulkAdGroupLabel オブジェクトをアップロードしてダウンロードする時間を節約できます。サービス操作を直接呼び出し、カスタム コードを記述して一括ファイル内の各フィールドを解析する代わりにします。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupLabel
var bulkAdGroupLabel = new BulkAdGroupLabel
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // LabelAssociation object of the Campaign Management service.
    LabelAssociation = new LabelAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = adGroupIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkAdGroupLabel);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

広告グループ ラベル レコードの場合は、一括ファイル スキーマで次の属性フィールドを使用できます。

• 広告グループ
• キャンペーン
• クライアント ID
• Id
• 変更時刻
• Parent Id
• 状態

広告グループ

このラベルが適用または削除される広告グループの名前。

追加： 読み 取り 専用
削除： 読み 取り 専用

キャンペーン

このラベルが適用または削除される広告グループを含むキャンペーンの名前。

追加： 読み 取り 専用
削除： 読み 取り 専用

クライアント ID

一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。

追加： オプション
削除： 読み 取り 専用

Id

広告グループに適用または削除されるラベルの識別子。

この一括フィールドは、ラベル レコードの Id フィールドにマップされます。

追加： 読み取り専用と必須。 既存のラベル識別子を指定するか、親 Label レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内の広告グループに新しいラベルを適用する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
削除： 読み取り専用と必須

変更時刻

エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。

追加： 読み 取り 専用
削除： 読み 取り 専用

Parent Id

このラベルが適用または削除される広告グループの識別子。

この一括フィールドは、広告グループ レコードの Id フィールドにマップされます。

追加： 読み取り専用と必須。 既存の広告グループ識別子を指定するか、親広告グループ レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内の新しい広告グループにラベルを適用する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
削除： 読み取り専用と必須

状態

広告グループとラベルの間で適用される状態を表します。

有効な値は [アクティブ] と [削除済み] です。 ラベルが広告グループに適用されている場合、このフィールドの値は [アクティブ] になります。

追加： 読み 取り 専用
削除： 必須。 [状態] を [削除済み] に設定する必要があります。