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

  • [アーティクル]

アカウントのメディア ライブラリに追加できる画像を定義します。

構文

<xs:complexType name="Image" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Media">
      <xs:sequence>
        <xs:element minOccurs="0" name="Data" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

Image オブジェクトには、Data という要素があります。

要素 説明 データ型
データ ライブラリに追加するイメージまたはアイコンを表す base64 文字列。 base64 文字列には、最大 102,400 文字を含めることができます。

制限事項とサポートされているデータ型については、以下 の「備考 」を参照してください。		 string

Image オブジェクトには継承された要素があります。

継承された要素

メディアから継承された要素

Image オブジェクトは Media オブジェクトから派生し、Id、MediaType、Text、Type の各要素を継承します。 以下の説明は Image に固有であり、 Media オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素 説明 データ型
身分証明書 メディアの一意の Microsoft Advertising 識別子。

足す： 読み取り専用		 long
MediaType ライブラリに追加するメディアの種類。

推奨されるメディアの種類は "GenericImage" です。

ImageAdExtension で使用されるメディアの場合、サポートされる値は GenericImage、Image16x9、Image15x10、Image4x3、Image12x10 です。

ResponsiveAd で使用されるメディアの場合、サポートされる値は GenericImage、Image1x1、Image191x100、Image4x1 です。

サポートされている縦横比の詳細については、以下の 「解説 」セクションを参照してください。

足す： 必須		 string
テキスト 画像の代替テキスト。 string
型 メディアの種類。

メディアの種類の詳細については、「 メディア データ オブジェクトの備考」を参照してください。

足す： 読み取り専用		 string

解説

イメージ メディアの種類は、アップロードされたイメージのサポートされている縦横比を示します。

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

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

Sub Type 縦横比 最小ディメンション
GenericImage さまざま 幅 40 x 高さ 20 ピクセル
Image16x9 16:9 幅 640 x 高さ 360 ピクセル
Image15x10 1.5:1 幅 300 x 高さ 200 ピクセル
Image4x3 4:3 幅 100 x 高さ 75 ピクセル
Image1x1 1:1 幅 128 x 高さ 128 ピクセル
Image191x100 1.91:1 幅 703 x 高さ 368 (ピクセル単位)
Image4x1 4:1 幅 512 x 高さ 128 ピクセル

注:

ピクセル単位の最大幅と高さは 2592 と 2048 であり、サポートされている縦横比のいずれかを維持する必要があります。 たとえば、サブタイプが Image191x100 で、幅が 2592 の場合、高さは 1357 である必要があります。

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

  • GIF
  • JPEG
  • PNG

ヒント

PNG イメージは JPEG に変換されます。 変換後の品質に満足できない場合は、JPEG を直接提供することをお勧めします。

要件

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