通过

ImageAsset 数据对象 - 市场活动管理

  • 项目

将裁剪设置应用于特定纵横比的存储图像媒体。

注意

还不是每个人都有此功能。 如果你没有，别担心。 它即将推出。

如果未指定裁剪设置，该服务将自动从图像中心裁剪到最大可能区域。 例如，给定 1000x1000 像素 的图像，对于 1.91：1 纵横比，自动裁剪设置将为 CropWidth=1000、 CropHeight=524、 CropX=0 和 CropY=238。

语法

<xs:complexType name="ImageAsset" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Asset">
      <xs:sequence>
        <xs:element minOccurs="0" name="CropHeight" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="CropWidth" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="CropX" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="CropY" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="SubType" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TargetHeight" nillable="true" type="xs:int">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="TargetWidth" nillable="true" type="xs:int">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

ImageAsset 对象具有以下元素：CropHeight、CropWidth、CropX、CropY、SubType、TargetHeight、TargetWidth。

元素 说明 数据类型
CropHeight 要从图像资产源使用的像素数，从 CropY 位置开始向上移动。

加： 自选。 如果未设置此元素，服务将根据 SubType 的纵横比自动裁剪。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 int
CropWidth 要从图像资产源使用的像素数，从 CropX 位置开始，向右移动。

加： 自选。 如果未设置此元素，服务将根据 SubType 的纵横比自动裁剪。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 int
CropX 从图像资产源的左下角开始，这是应用 CropWidth 之前要跳到 X 轴右侧的像素数。

加： 自选。 如果未设置此元素，服务将根据 SubType 的纵横比自动裁剪。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 int
CropY 从图像资产源的左下角开始，这是应用 CropHeight 之前在 y 轴上向上跳过的像素数。

加： 自选。 如果未设置此元素，服务将根据 SubType 的纵横比自动裁剪。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 int
SubType 表示此图像资产的纵横比。

子类型的纵横比必须与有效的图像资产维度匹配。 如果未使用 CropHeight 和 CropWidth ，则子类型的纵横比必须与存储的图像媒体的纵横比匹配。 如果使用 CropHeight 和 CropWidth ，则存储在帐户级别媒体库中的媒体的真实纵横比可能会有所不同，只要 CropHeight 和 CropWidth 产生正确的纵横比。 在任一情况下，存储在帐户级别媒体库中的媒体的真实纵横比将保持不变。

如果图像与广告关联为“LandscapeLogoMedia”或“SquareLogoMedia”，则必须将子类型设置为“徽标”。

可能的子类型值包括 OriginalImage、LandscapeLogoMedia、SquareLogoMedia、LandscapeImageMedia、SquareImageMedia、ImageMedia169X100、ImageMedia201X100、ImageMedia120X100、ImageMedia200X100、ImageMedia124X100、ImageMedia153X100。 有关详细信息，请参阅 ResponsiveAd 备注。

注意：从现在起，SubType OriginalImage 将 LandscapeImageMedia 的角色取代为 Audience Campaign 的 ResponsiveAd 的默认图像。

将来可能会添加新的子类型，因此不应依赖于一组固定值。

加： 必填
更新： 只读。 不能在更新期间更新子类型。		 string
TargetHeight 图像资产的目标高度维度。 int
TargetWidth 图像资产的目标宽度维度。 int

ImageAsset 对象具有 Inherited Elements。

继承的元素

从资产继承的元素

ImageAsset 对象派生自 Asset 对象，并继承以下元素：Id、Name、Type。 以下说明特定于 ImageAsset，可能不适用于从 Asset 对象继承相同元素的其他对象。

元素 说明 数据类型
ID Microsoft广告帐户中资产的唯一Microsoft广告标识符。

同一图像资产标识符可以在同一广告中多次用于不同的纵横比，也可以由同一Microsoft广告帐户中的多个广告使用。 将 SubType 设置为 LandscapeImageMedia 的图像资产标识符用于同一广告中的所有自动生成的图像资产子类型。 无论你是否让Microsoft广告自动生成裁剪的图像， ID 在链接到同一广告的图像资产中不需要是唯一的。

可以通过 AddMedia 服务操作为响应式广告创建媒体。 然后，可以使用返回的媒体标识符作为图像资产 ID。 图像资产 SubType 必须支持添加的图像的纵横比。

加： 必填
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 long
名称 保留供以后使用。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 string
类型 资产的类型。 检索图像资产时，此值为 ImageAsset 。 有关资产类型的详细信息，请参阅 资产数据对象备注。

加： 只读
更新： 只读		 string

要求

服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13

使用者

VideoAsset