Google AdSense API(公开为 Web 服务)主要针对那些想要加入 Google 的 AdSense 计划的用户。Google 的 AdSense 计划是一个收入分享模式,用户允许 Google 将一些小部件放在用户的站点上。根据用户网站的内容,这些小部件可以是广告的形式,也可以是 Google 搜索小部件(像本教程中使用的例子)。无论哪种情况,Google 都将与用户分享这些小部件吸引的点击所带来的收入。
添加这些小部件需要进行一些编程(比如在这个例子中),通常要求您了解一些有关 Web 服务的知识。但是,本教程说明了如何使用 NetBeans IDE 向您的站点添加一个 Google 搜索小部件,您几乎不需要什么相关的知识和编码操作。
注意:在本教程中,我们将会与 Google 开发人员沙箱交互。它的规则可能随时改变。如果您遇到了运行时错误,或者如果本教程中指定的值不起作用,建议您阅读浏览器中显示的错误信息,然后仔细检查是否输入了错误的值。如果一切正常,则可能 Google 开发人员沙箱的值已经更改了。要调整该值,请参考 http://code.google.com/apis/adsense/。
首先,您需要创建一个 Web 项目。在本例中,我们将使用“新建项目”向导中包含的一个样例作为我们的起点。
选择“文件”>“新建项目”。在“类别”下,选择“样例”,然后选择“REST 风格的 Web 服务”。在“项目”下,选择“客户数据库”,如下所示:
单击“下一步”,然后单击“完成”。
该样例项目会在 IDE 中打开,并且其项目概要会显示在“项目”窗口中。
添加 Google Web 服务
通过从“组件面板”中拖放项目,您可以让 IDE 生成与 Google Web 服务通信所需的所有代码。完成之后,您可以引用相关的 Google API(如下所示)来自定义代码。最后,IDE 会通过提供一个调用该 Web 服务上所有可用操作的 Web 客户机,帮助您测试该应用程序。
要添加 Google Web 服务,请执行以下操作:
打开 customerdb.service 包中的 CustomerResource 类。
向该类添加以下方法:
@Path("adSenseForSearch")
@GET
@ProduceMime("text/html")
public String getAdSenseForSearchCode() {
// dnd here and return the generated html code.
return null;
}
在 IDE 中打开“服务”选项卡。展开“Web 服务”节点。您会看到一个 Web 服务的列表。找到 Google 节点并展开它。从 Google 服务列表中,找到 AdSenseForSearch Service 并展开它,显示 GoogleAdSenseForSearch 操作。
将以下内容添加到 getAdSenseForSearch 方法体,下面 // TODO process result here:
domains = java.util.Arrays.asList(new String[]{selectedDomain});
// Set the search options
searchOptions = new SearchOptions();
// Set the site properties
siteProperties = new com.google.api.adsense.v2.SiteProperties();
siteProperties.setLocale("en");
siteProperties.setEncoding("");
// Set the style
searchBoxStyle = new com.google.api.adsense.v2.SearchBoxStyle();
searchBoxStyle.setLogoType("GoogleLogo");
searchBoxStyle.setBackgroundColor("#CCCCCC");
searchBoxStyle.setTextColor("black");
searchBoxStyle.setTextBoxLength(40);
searchBoxStyle.setSearchStyleName("Blue Sky");