Re: ForwardCompatibilityMap missing from response campaignservice
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.
Re: ForwardCompatibilityMap missing from response campaignservice
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.
Re: ForwardCompatibilityMap missing from response campaignservice
Hi Danial, Thank you for your reply. It would have been nice to know this change was coming. Did we perhaps miss an announcement that it was to be removed? Kind regards, Jaap-Jan Op dinsdag 15 oktober 2013 15:18:04 UTC+2 schreef Danial Klimkin: Hello Jaap-Jan Frans, SuggestedBidModifier was a temporary field available for the period of Enhanced Campaigns migration only. It is no longer available in the UI and should not be returned via the API anymore. -Danial, AdWords API Team. On Monday, October 14, 2013 11:41:05 AM UTC+4, fr...@bgenius.com wrote: Dear Adwords Support Team, We use the ForwardCompatibilityMap of the Campaign object to retrieve suggested mobile bid adjustments. This weekend while downloading campaigns of clients accounts we noticed that sometimes the forward compatibility map is missing from the response we get from the API. When we investigated it further we noticed that the map randomly is included or excluded in the response Here are two request ID's to retrieve the exact same campaigns: 0004e8ade3ee40980ae5aac72dbd 0004e8ae0e301f980ae50e881430 The requests both have the same fields etc. (see the attachments) In the response soap message of the first request ID the map is missing. The response of the second request contains a map for each campaign. The responses are also included as attachments. Can you look into this matter? Thank you! Kind regards, Jaap-Jan Frans bGenius -- -- =~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~ 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.
Re: ForwardCompatibilityMap missing from response campaignservice
Hello Jaap-Jan, This property was only available as part of ForwardCompatibilityMap. This is the part of the API that provides certain functionality temporarily and can be updated in between releases. The change was announced in the migration guide: https://developers.google.com/adwords/api/docs/guides/migration-v201309 -Danial, AdWords API Team. On Wednesday, October 16, 2013 10:42:04 AM UTC+4, fr...@bgenius.com wrote: Hi Danial, Thank you for your reply. It would have been nice to know this change was coming. Did we perhaps miss an announcement that it was to be removed? Kind regards, Jaap-Jan Op dinsdag 15 oktober 2013 15:18:04 UTC+2 schreef Danial Klimkin: Hello Jaap-Jan Frans, SuggestedBidModifier was a temporary field available for the period of Enhanced Campaigns migration only. It is no longer available in the UI and should not be returned via the API anymore. -Danial, AdWords API Team. On Monday, October 14, 2013 11:41:05 AM UTC+4, fr...@bgenius.com wrote: Dear Adwords Support Team, We use the ForwardCompatibilityMap of the Campaign object to retrieve suggested mobile bid adjustments. This weekend while downloading campaigns of clients accounts we noticed that sometimes the forward compatibility map is missing from the response we get from the API. When we investigated it further we noticed that the map randomly is included or excluded in the response Here are two request ID's to retrieve the exact same campaigns: 0004e8ade3ee40980ae5aac72dbd 0004e8ae0e301f980ae50e881430 The requests both have the same fields etc. (see the attachments) In the response soap message of the first request ID the map is missing. The response of the second request contains a map for each campaign. The responses are also included as attachments. Can you look into this matter? Thank you! Kind regards, Jaap-Jan Frans bGenius -- -- =~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~ 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.
Re: ForwardCompatibilityMap missing from response campaignservice
Hi Danial, Thank you for pointing this out. However, the migration guide you refer to is the guide to migrate to V201309. On our production servers we use V201306. We do not expect a feature to break in a (still supported) previous version of the API, if it's discontinuation is mentioned only in the migration guide of a new version. We'd expect it to be supported until the sunset of the version before the latest one (in this case, the sunset of v201306 in march 2014). In the future it would be helpful if breaking changes that also affect previous versions of the API are mentioned on for example the developers blog, it would prevent a situation like this. Thanks! Kind regards, Jaap-Jan Frans Op woensdag 16 oktober 2013 14:51:04 UTC+2 schreef Danial Klimkin: Hello Jaap-Jan, This property was only available as part of ForwardCompatibilityMap. This is the part of the API that provides certain functionality temporarily and can be updated in between releases. The change was announced in the migration guide: https://developers.google.com/adwords/api/docs/guides/migration-v201309 -Danial, AdWords API Team. On Wednesday, October 16, 2013 10:42:04 AM UTC+4, fr...@bgenius.com wrote: Hi Danial, Thank you for your reply. It would have been nice to know this change was coming. Did we perhaps miss an announcement that it was to be removed? Kind regards, Jaap-Jan Op dinsdag 15 oktober 2013 15:18:04 UTC+2 schreef Danial Klimkin: Hello Jaap-Jan Frans, SuggestedBidModifier was a temporary field available for the period of Enhanced Campaigns migration only. It is no longer available in the UI and should not be returned via the API anymore. -Danial, AdWords API Team. On Monday, October 14, 2013 11:41:05 AM UTC+4, fr...@bgenius.com wrote: Dear Adwords Support Team, We use the ForwardCompatibilityMap of the Campaign object to retrieve suggested mobile bid adjustments. This weekend while downloading campaigns of clients accounts we noticed that sometimes the forward compatibility map is missing from the response we get from the API. When we investigated it further we noticed that the map randomly is included or excluded in the response Here are two request ID's to retrieve the exact same campaigns: 0004e8ade3ee40980ae5aac72dbd 0004e8ae0e301f980ae50e881430 The requests both have the same fields etc. (see the attachments) In the response soap message of the first request ID the map is missing. The response of the second request contains a map for each campaign. The responses are also included as attachments. Can you look into this matter? Thank you! Kind regards, Jaap-Jan Frans bGenius -- -- =~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~ 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.
Re: ForwardCompatibilityMap missing from response campaignservice
Hello Jaap-Jan Frans, Thanks, I understand your concern. This particular field was only available in FCM and for Enhanced Campaign migration only. We try hard to not to introduce changes to the older versions outside of FCM. -Danial, AdWords API Team. On Wednesday, October 16, 2013 5:04:01 PM UTC+4, fr...@bgenius.com wrote: Hi Danial, Thank you for pointing this out. However, the migration guide you refer to is the guide to migrate to V201309. On our production servers we use V201306. We do not expect a feature to break in a (still supported) previous version of the API, if it's discontinuation is mentioned only in the migration guide of a new version. We'd expect it to be supported until the sunset of the version before the latest one (in this case, the sunset of v201306 in march 2014). In the future it would be helpful if breaking changes that also affect previous versions of the API are mentioned on for example the developers blog, it would prevent a situation like this. Thanks! Kind regards, Jaap-Jan Frans Op woensdag 16 oktober 2013 14:51:04 UTC+2 schreef Danial Klimkin: Hello Jaap-Jan, This property was only available as part of ForwardCompatibilityMap. This is the part of the API that provides certain functionality temporarily and can be updated in between releases. The change was announced in the migration guide: https://developers.google.com/adwords/api/docs/guides/migration-v201309 -Danial, AdWords API Team. On Wednesday, October 16, 2013 10:42:04 AM UTC+4, fr...@bgenius.comwrote: Hi Danial, Thank you for your reply. It would have been nice to know this change was coming. Did we perhaps miss an announcement that it was to be removed? Kind regards, Jaap-Jan Op dinsdag 15 oktober 2013 15:18:04 UTC+2 schreef Danial Klimkin: Hello Jaap-Jan Frans, SuggestedBidModifier was a temporary field available for the period of Enhanced Campaigns migration only. It is no longer available in the UI and should not be returned via the API anymore. -Danial, AdWords API Team. On Monday, October 14, 2013 11:41:05 AM UTC+4, fr...@bgenius.com wrote: Dear Adwords Support Team, We use the ForwardCompatibilityMap of the Campaign object to retrieve suggested mobile bid adjustments. This weekend while downloading campaigns of clients accounts we noticed that sometimes the forward compatibility map is missing from the response we get from the API. When we investigated it further we noticed that the map randomly is included or excluded in the response Here are two request ID's to retrieve the exact same campaigns: 0004e8ade3ee40980ae5aac72dbd 0004e8ae0e301f980ae50e881430 The requests both have the same fields etc. (see the attachments) In the response soap message of the first request ID the map is missing. The response of the second request contains a map for each campaign. The responses are also included as attachments. Can you look into this matter? Thank you! Kind regards, Jaap-Jan Frans bGenius -- -- =~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~ 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.
Re: ForwardCompatibilityMap missing from response campaignservice
Hello Jaap-Jan Frans, SuggestedBidModifier was a temporary field available for the period of Enhanced Campaigns migration only. It is no longer available in the UI and should not be returned via the API anymore. -Danial, AdWords API Team. On Monday, October 14, 2013 11:41:05 AM UTC+4, fr...@bgenius.com wrote: Dear Adwords Support Team, We use the ForwardCompatibilityMap of the Campaign object to retrieve suggested mobile bid adjustments. This weekend while downloading campaigns of clients accounts we noticed that sometimes the forward compatibility map is missing from the response we get from the API. When we investigated it further we noticed that the map randomly is included or excluded in the response Here are two request ID's to retrieve the exact same campaigns: 0004e8ade3ee40980ae5aac72dbd 0004e8ae0e301f980ae50e881430 The requests both have the same fields etc. (see the attachments) In the response soap message of the first request ID the map is missing. The response of the second request contains a map for each campaign. The responses are also included as attachments. Can you look into this matter? Thank you! Kind regards, Jaap-Jan Frans bGenius -- -- =~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~ 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.
ForwardCompatibilityMap missing from response campaignservice
Dear Adwords Support Team, We use the ForwardCompatibilityMap of the Campaign object to retrieve suggested mobile bid adjustments. This weekend while downloading campaigns of clients accounts we noticed that sometimes the forward compatibility map is missing from the response we get from the API. When we investigated it further we noticed that the map randomly is included or excluded in the response Here are two request ID's to retrieve the exact same campaigns: 0004e8ade3ee40980ae5aac72dbd 0004e8ae0e301f980ae50e881430 The requests both have the same fields etc. (see the attachments) In the response soap message of the first request ID the map is missing. The response of the second request contains a map for each campaign. The responses are also included as attachments. Can you look into this matter? Thank you! Kind regards, Jaap-Jan Frans bGenius -- -- =~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~ 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. ?xml version=1.0 encoding=UTF-8?soapenv:Envelope xmlns:soapenv=http://schemas.xmlsoap.org/soap/envelope/; xmlns:xsd=http://www.w3.org/2001/XMLSchema; xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance; soapenv:Header ns1:RequestHeader xmlns:ns1=https://adwords.google.com/api/adwords/cm/v201306; soapenv:mustUnderstand=0 ns1:clientCustomerId/ns1:clientCustomerId ns1:developerToken/ns1:developerToken ns1:userAgentbGenius (AwApi-Java, AdWords-Axis/1.18.1, Common-Java/1.18.1, Axis/1.4, Java/1.7.0_09, maven)/ns1:userAgent ns1:validateOnlyfalse/ns1:validateOnly ns1:partialFailurefalse/ns1:partialFailure /ns1:RequestHeader /soapenv:Header soapenv:Body get xmlns=https://adwords.google.com/api/adwords/cm/v201306; serviceSelector fieldsId/fields fieldsName/fields fieldsStatus/fields fieldsServingStatus/fields fieldsStartDate/fields fieldsEndDate/fields fieldsBudgetId/fields fieldsBiddingStrategyType/fields fieldsDeliveryMethod/fields fieldsAdServingOptimizationStatus/fields fieldsTargetGoogleSearch/fields fieldsTargetSearchNetwork/fields fieldsTargetContentNetwork/fields fieldsEnhanced/fields fieldsEnhancedCpcEnabled/fields predicates fieldStatus/field operatorNOT_IN/operator valuesDELETED/values /predicates paging startIndex0/startIndex numberResults1/numberResults /paging /serviceSelector /get /soapenv:Body /soapenv:Envelope?xml version=1.0 encoding=UTF-8?soap:Envelope xmlns:soap=http://schemas.xmlsoap.org/soap/envelope/; soap:Header ResponseHeader xmlns=https://adwords.google.com/api/adwords/cm/v201306; requestId0004e8ae0e301f980ae50e881430/requestId serviceNameCampaignService/serviceName methodNameget/methodName operations0/operations responseTime201/responseTime /ResponseHeader /soap:Header soap:Body getResponse xmlns=https://adwords.google.com/api/adwords/cm/v201306; rval totalNumEntries2/totalNumEntries Page.TypeCampaignPage/Page.Type entries id212005768/id nameSPE - Spelletjes Types/name statusACTIVE/status servingStatusSERVING/servingStatus startDate20130604/startDate endDate20371230/endDate budget budgetId144032368/budgetId periodDAILY/period deliveryMethodSTANDARD/deliveryMethod /budget campaignStats networkALL/network Stats.TypeCampaignStats/Stats.Type