Image Data Object

 

Defines an image object that can be added to an account’s media library.

The Image object derives from the Media object. For a list of the inherited elements, see the Media object.

<xs:complexType name="Image">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Media">
      <xs:sequence>
        <xs:element name="Data" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

The Image object derives from the Media object. For a list of the inherited elements, see Inherited Elements below.

ElementDescriptionData Type
DataA base64 string that represents the image or icon to add to the library. The base64 string can contain a maximum of 102,400 characters.

For information about restrictions and supported data types, see Image Data below.
string

The Image object derives from the Media object, and inherits the following elements.

System_CAPS_ICON_note.jpg Note

The descriptions below are specific to image media, and might not apply to other objects that inherit the same elements from the Media object.

ElementDescriptionData TypeAdd
IdThe unique Bing Ads identifier of the media.longRead-only
MediaTypeThe media type. For more information about media types, see the Media Data Object Remarks.stringRead-only
TypeThe type of media to add to the library.

For media that will be used with a LocationAdExtension, the supported values are Icon and Image.

For media that will be used with an ImageAdExtension, the supported values are Image16x9, Image15x10, Image4x3, and Image12x10.

For more information about supported aspect ratios, see the Image Data section below.
stringRequired

The following MIME types are supported for the Data element of the Image data object.

  • GIF
  • JPEG
  • PNG

Images with animation are not supported.

The following restrictions apply to Media that will be used with a LocationAdExtension.

  • If the value of the Type element is Icon, the maximum supported icon size is 26X26.
  • If the value of the Type element is Image, the maximum supported image size is 125X125.

The following restrictions apply to Media types (aspect ratios) that will be used with an ImageAdExtension.

TypeAspect RatioMinimum DimensionMaximum Dimension
Image16x916:9640 width x 360 height, in pixels1778 width x 1000 height, in pixels
Image15x101.5:1300 width x 200 height, in pixels1500 width x 1000 height, in pixels
Image4x34:3100 width x 75 height, in pixels1333 width x 1000 height, in pixels
Image12x101.2:1300 width x 250 height, in pixels1200 width x 1000 height, in pixels
System_CAPS_ICON_note.jpg Note

The maximum file size is 5 MB, but the recommended maximum file size is 1MB.

CampaignManagementService.svc v10

Namespace: https://bingads.microsoft.com/CampaignManagement/v10

AddMediaGetMediaByIdsGetMediaMetaDataByIds

Community Additions

ADD
Show: