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 [email protected]
To unsubscribe from this group, send email to
[email protected]
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 [email protected].
For more options, visit https://groups.google.com/groups/opt_out.
