イメージ レコード - 一括

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

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

次の一括 CSV の例では、新しいイメージを追加します。

Type,Status,Id,Parent Id,Client Id,Modified Time,Text,Url,Name
Format Version,,,,,,,,,,6.0
Image,Active,-20,0,ClientIdGoesHere,,My Image,https://contoso.com/PhotoStock_123.jpg,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkImage
var bulkImage = new BulkImage
{
    // 'Id' column header in the Bulk file
    Id = imageIdKey,
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Height' column header in the Bulk file
    Height = null,
    // 'Width' column header in the Bulk file
    Width = null,
    // 'Url' column header in the Bulk file
    Url = "https://contoso.com/PhotoStock_123.jpg",
    // 'Sub Type' column header in the Bulk file
    SubType = "GenericImage",
    // 'Text' column header in the Bulk file
    Text = "My Image",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkImage);

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

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

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

• クライアント ID
• Height
• Id
• 変更時刻
• Parent Id
• 状態
• Sub Type
• テキスト
• Url
• Width

クライアント ID

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

足す： 随意
削除： 読み取り専用

Height

メディア ライブラリに格納されているイメージの高さ。

表示される画像のサイズは、レスポンシブ広告の [画像] フィールドで定義されているように、アセット リンクの縦横比に部分的に依存します。

足す： 読み取り専用
削除： 読み取り専用

Id

イメージのシステム生成識別子。

足す： 随意。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 その後、画像に対して設定された負の識別子は、レスポンシブ広告の [画像] フィールドなどの依存レコードの種類で参照できます。 これは、同じ Bulk ファイルに新しいイメージと新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
削除： 読み取り専用と必須

変更時刻

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

足す： 読み取り専用
削除： 読み取り専用

Parent Id

イメージを含むアカウントのシステム生成識別子。

この一括フィールドは、取引先企業レコードの Id フィールドにマップされます。

足す： 読み取り専用
削除： 読み取り専用

状態

イメージの状態。

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

足す： 随意。 既定値は [アクティブ] です。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

Sub Type

画像のサブタイプは、アップロードされた画像のサポートされている縦横比を示します。

幅が 703 x 高さ 368 以上の "GenericImage" をピクセル単位で指定することをお勧めします。

画像が広告に "LandscapeLogoMedia" または "SquareLogoMedia" として関連付けられている場合は、サブタイプを "ロゴ" に設定する必要があります。

対応するディメンションと縦横比の制限を持つサポートされているすべてのサブタイプ値を以下に示します。

アニメーションを含む画像はサポートされていません。 次の MIME の種類がサポートされています。

• GIF
• JPEG
• PNG

足す： 必須
削除： 読み取り専用

テキスト

メディア ライブラリに格納されているイメージのカスタム テキストまたはラベル。

足す： 随意
削除： 読み取り専用

Url

イメージにアクセスできる URL。

新しいイメージをアップロードするには、Bulk サービスがイメージにアクセスして取得できる一時的な URL を指定する必要があります。

イメージをダウンロードすると、このフィールドには Bulk サービスによって提供される URL が含まれます。この URL を使用すると、必要に応じて保存されたイメージにアクセスして取得できます。

PNG または JPEG イメージをアップロードできます。 アニメーションを含む画像はサポートされていません。 PNG イメージは JPEG に変換されます。 変換後の品質に満足できない場合は、JPEG を直接提供することをお勧めします。

足す： 必須
削除： 読み取り専用

Width

メディア ライブラリに格納されているイメージの幅。

表示される画像のサイズは、レスポンシブ広告の [画像] フィールドで定義されているように、アセット リンクの縦横比に部分的に依存します。

足す： 読み取り専用
削除： 読み取り専用