Hello Jeff,
Thank you for the feedback. I will follow up internally with the teams to improve the way we make changes to the FCMaps. -Danial, AdWords API Team. On Thursday, October 17, 2013 11:14:23 PM UTC+4, Jeff Theroux wrote: > > Danial, it is well documented and understood that new attributes could be > added to the FCM between API versions. I think the issue here is it was > never made clear that the FCM would change across multiple versions > (v201306, v201302) of the API by removing attributes from older versions of > the API where the functionality was not exposed. The API doc states: > > "A note of caution: Keys exposed in forward compatibility maps will > become real attributes of the objects in a future API release; at that > point, the API will stop honoring these specific keys in preference of the > equivalent attributes." > > "keys are exposed/accepted only on API versions that don’t have the > functionality already exposed." > > That, to me, implies that keys in the FCM will stick around in old API > versions (and not be removed) but that new keys can be added at any time to > old versions of the API. If the FCM can change (announced or unannounced) > across multiple versions the documentation needs to be updated to more > explicitly document that behavior. If it's documented that keys can be > removed, that will allow developers to put appropriate fallbacks in place > > The migration guide / v201309 announcement was posted on the blog on > October 3rd and the suggested bid modifier was removed from v201302 and > v201306 on October 15th. We were fortunate to be able to push a fix on the > same day we noticed it, but seven business days might not allow enough time > for all API clients to code and deploy a fix to all production servers. > > My request is the same as Jaap-Jan Frans, to post upcoming > backwards-incompatible changes to the mailing list and blog, but also to > treat backwards-incompatible changes similar to new API releases and give > us more advance notice so we can better plan for it, and do the work at a > time that is convenient for us. > > Thanks, > > Jeff > > > -- -- =~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~ Also find us on our blog and discussion group: http://adwordsapi.blogspot.com http://groups.google.com/group/adwords-api =~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~ You received this message because you are subscribed to the Google Groups "AdWords API Forum" group. To post to this group, send email to adwords-api@googlegroups.com To unsubscribe from this group, send email to adwords-api+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/adwords-api?hl=en --- You received this message because you are subscribed to the Google Groups "AdWords API Forum" group. To unsubscribe from this group and stop receiving emails from it, send an email to adwords-api+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/groups/opt_out.
