整体示例

基础知识

我们开发了AdSense Host API整体示例来说明发布商注册流程中从开始帐户关联到生成广告代码的每一个步骤。

注册流程分为4个步骤:

  1. 托管商通过调用associationsessions.start来请求新的关联会话。
  2. 托管商将发布商重定向到在返回的关联会话中提供的AdSense网站网址。随后发布商在该位置完成表单填写。
  3. 发布商被重定向回托管商的网站(该网站具有在 HTTP 请求中指定的令牌参数)。
  4. 托管商通过调用associationsessions.verify来验证令牌。如果关联已成功创建,响应中会包括发布商的帐户ID(托管商应在本地存储此帐户 ID),以便在后续涉及该发布商的API调用中使用。

获取发布商的帐户ID后,托管商还需要执行2个步骤:

  1. 通过调用accounts.adunits.insert在发布商帐户上创建新的广告单元。
  2. 通过调用accounts.adunits.getAdCode为新广告单元生成广告代码。

安装整体示例

  1. 首先下载并安装最新版本的Google API Python客户端库。您可以在项目页面的下载部分找到一些可下载的软件包,但我们建议您使用pip下载并安装。
  2. 下载并安装Django,确保版本为1.5.x(更旧或更新的版本可能会出现兼容性问题)。我们同样建议使用pip执行此操作。
  3. 下载并安装整体示例
  4. git clone https://code.google.com/p/adsense-apis-showcase
  5. 修改samplehost/settings.py以添加数据库信息,设置引擎和名称字段。下面是sqlite3的一些示例设置:
  6. DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.sqlite3',
            'NAME': '/path/to/your_db.db',
            'USER': '',
            'PASSWORD': '',
            'HOST': '',
            'PORT': '',
        }
    }
    
  7. 在同一个文件中,将TEMPLATE_DIRS设为模板文件目录的绝对路径。此处指整体示例安装中的templates/子目录。
  8. 在Django项目完全配置后,您需要初始化数据库。从整体示例安装的根目录下,运行下面的命令:
  9. python manage.py syncdb
  10. 接下来,将您的开发者凭据添加到client_secrets.json。只要您创建了网络应用客户端ID,就可以在API控制台中找到这些凭据。
  11. 最后,针对API执行初始身份验证以创建adsensehost.dat(它将存储Google授权服务传回给您的凭据数据)。请注意使用您的AdSense Host帐户执行此操作。从整体示例安装的根目录下,运行下面的命令:
    python api_utils.py

下面的视频将演示完整的示例安装过程。

运行整体示例

  1. 启动本地Django服务器来运行应用;从整体示例安装的根目录下,运行下面的命令:
    python manage.py runserver
  2. 确保复制服务网址。网址通常是http://localhost:8000(如果使用IPv4地址,则为http://127.0.0.1:8000),但可能因您的设置而有所不同。
  3. 在浏览器中打开服务网址,并点击仅有的一个博客。您将看到一个没有广告的示例博客。您现在是拥有这个博客的发布商,正在寻求通过此博客获利。
  4. 打开博客的管理页面。您将看到“使用AdSense从您的博客获利”链接。点击该链接。
  5. 您将重定向到AdSense注册页面,您可以选择创建新帐户或登录现有帐户。
  6. 完成所有的注册步骤后,您将重定向到整体示例安装上的回调网址(默认设置下为http://localhost:8000/callback)。
  7. 示例将验证收到的令牌,创建广告单元,生成广告代码,然后将您重定向到您的博客,博客的顶部现在将展示广告。进入管理页面,您将看到新创建(或关联)的发布商帐户的发布商ID。

下面的视频将演示如何运行整体示例。