Missing required fields error with AdService

[Markus Heiden]

Hello,

I tried to update the final URL of an existing expanded text ad by creating a SET operation with just the ad id and the new final URL and passing it to AdService.mutate.

But AdWords complains about a missing headlinePart1, headlinePart2 and description.

With all other services I just need to set the id and the field(s) to change. Fields to keep need not to be set. Is that different with the AdService and where is this behavior documented?

When setting all fields of the ad to the same values as before (except the final URL), are the performance data of the ad retained as promised?

Thanks,

Markus

[Dannison Yao (AdWords API Team)]

Hi Markus,

According to this guide, in order to update your ad, you also have to SET one of the following fields (headlinePart1, headlinePart2 and description) as well. 

Let me know if this helps.

Regards,

Dannison

AdWords API Team

[Markus Heiden]

Hi Dannison,

I already read that guide (just the german version, because I found no switch for the language) and there is no point about updating expanded text ads, just the creation via the AdGroupAdService is mentioned.

My concern is that there are no details about updating expanded text ads via the AdService in the api documentation clearly stating which fields are required and that the performance data of the ad are kept.

According to your answer: Is it enough for an update via AdService.mutate to pass the id, headlinePart1, headlinePart2, description plus the field I want to change and the values of all other fields are kept?

Regards,

Markus

[Dannison Yao (AdWords API Team)]

Hi Markus,

To answer your question, yes, you are correct. As explained in the guide I have provided, you could use the AdService.mutate() to update expanded text ads provided that you include the id, headlinePart1, headlinePart2, and the description of the ad. Other attributes of the ad will retain as long as you did not include it in your fields to be updated.

Regards,

Dannison

AdWords API Team

[Markus Heiden]

Hi Dannison,

thanks for clarify the required fields and update details.

But there is still no statement regarding whether the performance data are kept under all circumstances. 

Are the performance data still kept, if I update all fields or just if I update only headlinePart1, headlinePart2, description and the URLs?

It would be nice, if that will be clearly documented in the API documentation of the AdService. 

BTW 

The german version of the mentioned guide does not contain any information regarding AdService.mutate(). 

Inserting a "?hl=en" before the "#" in the url gives me the english version, which contains the wanted information.

Regards,

Markus

[Dannison Yao (AdWords API Team)]

Hi Markus,

My apologies for missing this out. Performance data is still retained even after updating the details of the ad. This should not affect your metrics reports.

I can file a feature request for documentation update on your behalf. If you wish to do so, could you provide the link of the German documentation that you wanted to include the information?

Regards,

Dannison

AdWords API Team