Google会定期使用最新功能更新AdWords API。虽然不必等待太久才能获得新功能,但是它也有一个缺点:AdWords脚本可能会在脚本转换为使用较新版本的API的那一天停止工作。
原因是新的API版本可能会重命名或删除指标和属性。未使用这些最新名称更新的AdWords脚本将停止工作。
发布日期并不总是AdWords脚本开始使用较新版本的日期。因此,确保您编写的脚本可以继续工作是非常棘手的。
幸运的是,有一个解决方案,它很简单,只需包含可选的apiVersion参数,告诉脚本应使用哪个API版本。
没有API版本的报告调用:
var report2 = AdWordsApp.report(
'SELECT AdGroupId, Id, KeywordText, Impressions, Clicks ' +
'FROM KEYWORDS_PERFORMANCE_REPORT ' +
'DURING 20130101,20130301');
以及与API版本相同的调用:
var report2 = AdWordsApp.report(
'SELECT AdGroupId, Id, KeywordText, Impressions, Clicks ' +
'FROM KEYWORDS_PERFORMANCE_REPORT ' +
'DURING 20130101,20130301', {
apiVersion: 'v201605'
});
通过告诉脚本使用哪个API版本,您可以确保它在Google将默认值切换为新版本的那一天将继续工作,因为您现在可以控制告诉脚本的开关何时更新了代码并应开始使用新的API版本。
您仍然需要在某个时候进行迁移,但是您将需要几个月的时间来进行迁移。上表中的日落日期表示脚本可以使用特定API版本的最后一天。在该日期之后,旧版本将停止工作。
请注意,您不必遍历每个API版本。如果您不需要某个版本的功能,则完全可以跳过该版本。例如,假设您正在使用v201609。由于它要到2017年10月2日才到期,因此您可以等待2017年8月9日发布v201708,而跳过这两个API版本。
Optmyzr增强脚本库中的脚本会为我们的用户自动处理所有这些API转换,因此,如果您不想处理API版本,可以尝试一下。 (Optmyzr是我的雇主)