Question about EditorialStatus in ImageAsset (Microsoft Advertising API)

Question

Question about EditorialStatus in ImageAsset (Microsoft Advertising API)

ryoheimita-8112 0

Hello,

I have a question about the Microsoft Advertising Bing Ads API.

When retrieving ads using the GetAdsByAdGroupId operation, I found that for ResponsiveAd types, the Images (an array of AssetLink elements) are returned.

However, the EditorialStatus field within each AssetLink always appears to be null.

According to the documentation, the following statuses are expected to be returned:

Unknown
Active
Disapproved
ActiveLimited

Does this mean that EditorialStatus is not applicable or not set for ImageAsset types?

Below is an excerpt from the response for your reference:

<Images>
  <AssetLink>
    <Asset i:type="ImageAsset">
      <Id>7353042664017</Id>
      <Name i:nil="true"/>
      <Type>ImageAsset</Type>
      <CropHeight>628</CropHeight>
      <CropWidth>1200</CropWidth>
      <CropX>0</CropX>
      <CropY>0</CropY>
      <SubType>LandscapeImageMedia</SubType>
    </Asset>
    <AssetPerformanceLabel>Unrated</AssetPerformanceLabel>
    <EditorialStatus i:nil="true"/>
    <PinnedField i:nil="true"/>
  </AssetLink>
  <AssetLink>
    <Asset i:type="ImageAsset">
      <Id>7353042664011</Id>
      <Name i:nil="true"/>
      <Type>ImageAsset</Type>
      <CropHeight>628</CropHeight>
      <CropWidth>1200</CropWidth>
      <CropX>0</CropX>
      <CropY>0</CropY>
      <SubType>LandscapeImageMedia</SubType>
    </Asset>
    <AssetPerformanceLabel>Unrated</AssetPerformanceLabel>
    <EditorialStatus i:nil="true"/>
    <PinnedField i:nil="true"/>
  </AssetLink>
  <!-- (truncated for brevity) -->
</Images>

Could you please confirm whether this behavior is expected?

Thank you for your help.

Best regards,

1 answer

Your answer

Answer 1

MS Advertising - Arsen 155 Microsoft External Staff Moderator

Hi,

Thank you for reaching out to the Microsoft Advertising Learn Q&A Platform.

Thank you for your question regarding the Microsoft Advertising Bing Ads API and the behavior of the EditorialStatus field within AssetLink elements for ResponsiveAd types.

Based on current observations and documentation, it appears that the EditorialStatus field for image assets (i.e., ImageAsset types) returned via the GetAdsByAdGroupId operation may indeed be null.

While the documentation lists possible values such as:

Unknown
Active
Disapproved
ActiveLimited

…the fact that EditorialStatus is consistently null suggests that this field may not yet be populated for image assets in this context. This could be due to the relatively recent introduction of asset-level editorial review features on the platform, and it's possible that the editorial status is either not applicable or not yet retrieved for these asset types.

Our support teams are happy to discuss your account in more detail via phone, chat or email to provide review assistance, please see our support page to reach out!

Kind regards,

Arsen D. | Microsoft Advertising Support Specialist | 800-518-5689

ryoheimita-8112 0

Thank you for your response.

I tried retrieving the data using a different account, and in that case, I was able to obtain the information as shown below.

<Images>
  <AssetLink>
    <Asset i:type="ImageAsset">
      <Id>7353137358911</Id>
      <Name i:nil="true" />
      <Type>ImageAsset</Type>
      <CropHeight i:nil="true" />
      <CropWidth i:nil="true" />
      <CropX i:nil="true" />
      <CropY i:nil="true" />
      <SubType>LandscapeLogoMedia</SubType>
    </Asset>
    <AssetPerformanceLabel>Unrated</AssetPerformanceLabel>
    <EditorialStatus>Active</EditorialStatus>
    <PinnedField i:nil="true" />
  </AssetLink>
  <AssetLink>
    <Asset i:type="ImageAsset">
      <Id>7353137358909</Id>
      <Name i:nil="true" />
      <Type>ImageAsset</Type>
      <CropHeight i:nil="true" />
      <CropWidth i:nil="true" />
      <CropX i:nil="true" />
      <CropY i:nil="true" />
      <SubType>SquareLogoMedia</SubType>
    </Asset>
    <AssetPerformanceLabel>Unrated</AssetPerformanceLabel>
    <EditorialStatus>Active</EditorialStatus>
    <PinnedField i:nil="true" />
  </AssetLink>
  <AssetLink>
    <Asset i:type="ImageAsset">
      <Id>7353137358934</Id>
      <Name i:nil="true" />
      <Type>ImageAsset</Type>
      <CropHeight i:nil="true" />
      <CropWidth i:nil="true" />
      <CropX i:nil="true" />
      <CropY i:nil="true" />
      <SubType>LandscapeImageMedia</SubType>
    </Asset>
    <AssetPerformanceLabel>Unrated</AssetPerformanceLabel>
    <EditorialStatus>Active</EditorialStatus>
    <PinnedField i:nil="true" />
  </AssetLink>
  <AssetLink>
    <Asset i:type="ImageAsset">
      <Id>7353137358936</Id>
      <Name i:nil="true" />
      <Type>ImageAsset</Type>
      <CropHeight i:nil="true" />
      <CropWidth i:nil="true" />
      <CropX i:nil="true" />
      <CropY i:nil="true" />
      <SubType>LandscapeImageMedia</SubType>
    </Asset>
    <AssetPerformanceLabel>Unrated</AssetPerformanceLabel>
    <EditorialStatus>Active</EditorialStatus>
    <PinnedField i:nil="true" />
  </AssetLink>
  <!-- (truncated for brevity) -->
</Images>

Could there be an issue with the previous account?

Best regards,

Share via

Question about EditorialStatus in ImageAsset (Microsoft Advertising API)

1 answer

Your answer