次の方法で共有

ラベル レコード - 一括

  • [アーティクル]

一括ファイルでアップロードおよびダウンロードできるラベルを定義します。

ラベルを使用すると、重要な内容に基づいてキャンペーン、広告グループ、広告、キーワードをグループにまとめることができます。 その後、ラベルに対してレポートをフィルター処理して実行して、最も意味のあるデータを取得できます。

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

次の一括 CSV の例では、新しいラベルを追加します。

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

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

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    Label = new Label
    {
        // 'Color' column header in the Bulk file
        ColorCode = "#FFFFFF",
        // 'Description' column header in the Bulk file
        Description = "Label Description",
        // 'Id' column header in the Bulk file
        Id = labelIdKey,
        // 'Label' column header in the Bulk file
        Name = "Label Name " + DateTime.UtcNow
    },

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

uploadEntities.Add(bulkLabel);

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

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

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

色

16 進コードとしてのラベルの色。

16 進数の値には、'#' プレフィックスが必要です。 たとえば、白ラベルには #FFFFFF の値を使用できます。

色は、Microsoft Advertising Web アプリケーションで表示できます。 アプリケーションでは、色を表示したり、16 進値を利用して一連のラベルを分類したりできます。

追加： オプション。 色を指定しない場合、値はラベルごとにランダムに割り当てられます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 カラー コードは更新できますが、削除することはできません。
削除： 読み 取り 専用

クライアント ID

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

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

説明

ラベルの説明。

ラベルの説明の長さは 1 から 200 文字です。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

Id

ラベルのシステム生成識別子。

追加： オプション。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 ラベルに設定された負の識別子は、キャンペーン ラベルなどの依存レコードタイプの [親 ID] フィールドで参照できます。 これは、同じ Bulk ファイルに新しいラベルと新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

Label

ラベル名。

大文字と小文字を区別するラベル名の長さは 1 から 80 文字で、アカウント内のすべてのラベルで一意である必要があります。

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

変更時刻

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

注:

日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。

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

状態

ラベルの状態。

使用可能な値は [アクティブ] または [削除済み] です。

追加： オプション。 既定値は [アクティブ] です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。