PHP实现谷歌短网址服务的API接口调用

前面整理了一篇文章《PHP实现百度、网易、新浪短网址服务的API接口调用》，这篇文章就来说说如何用PHP实现谷歌短网址API接口的调用。谷歌短网址的API接口功能比较丰富，还能analytics某个短网址，例如点击量创建时间等等。

1 谷歌短网址API接口介绍

谷歌短网址（Google url shortener）页面是http://goo.gl/，官方API文档说明是：点击进入。同新浪短网址的API一样，谷歌短网址的API调用可以通过两种授权方式（Authentication）实现。正如文档中所提到的：

Every request your application sends to the Google URL Shortener API needs to identify your application to Google. There are two ways to identify your application: using an OAuth 2.0 token (which also authorizes the request) and/or using the application's API key.（你的应用向谷歌短网址API服务器所发送的每一个请求，都需要向Google提供合法证明。有如下两种渠道来识别你的应用：使用一个OAuth 2.0 token，或者使用应用的API KEY）。由于OAuth 2.0的认证过程相对麻烦，而且谷歌官方文档也说了“An API key is highly recommended”，所以这里就使用第二种API KEY来实现。

2 使用Google url shortener的API KEY来调用谷歌短网址API

Google url shortener的API KEY申请方式见《Google 开发者控制台Developers Console简单介绍以及API KEY的生成》。在获得了API KEY后就可以使用下面的代码来实现谷歌短网址的API接口调用了：

<?php
    /**
    * @author: vfhky 201403012 20:31
    * @description: PHP调用谷歌短网址API接口
    * @reference: http://goo.gl/Ro277L
    * @param string $type: 非零整数代表长网址转短网址,0表示短网址转长网址
    * @note: 长网址转短网址采用POST模式,短网址转长网址采用Get模式
    */
    function ggUrlAPI($type,$url){
      if($type){
         /* The API key is safe for embedding in URLs; it doesn't need any encoding. */
         $key = 'AIzaSyBlRWs2M5c6a04l-YSDUpUKtlsvDK1hL1Q';//这是我申请的KEY，大家可以测试用
         $data = array('longUrl' => $url, 'key' => $key);
         /* requests containing JSON content bodies must be accompanied by a Content-Type: application/json request header */
         $post = json_encode($data);
         $baseurl = 'https://www.googleapis.com/urlshortener/v1/url';
      }
      else
         $baseurl = 'https://www.googleapis.com/urlshortener/v1/url?shortUrl='.$url;
      $ch = curl_init();
      curl_setopt($ch, CURLOPT_URL, $baseurl);
      curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
      curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
      curl_setopt($ch, CURLOPT_HEADER, 0);
      if($type){
         curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-type:application/json'));
         curl_setopt($ch, CURLOPT_POST, 1);
         curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
      }
      $response = curl_exec($ch);
      $arrResponse = json_decode($response);
      curl_close($ch);
      return $arrResponse;
    }
    echo '谷歌短网址API接口测试结果: <br/> ';
    echo 'Long to Short: ';
    print_r(ggUrlAPI(1,'http://vfhky.sinaapp.com'));
    echo '<br/><br/>';

    echo 'Short to Long: ';
    print_r(ggUrlAPI(0,'http://goo.gl/F90bfL'));
    echo '<br/><br/>';
?>

3 要说明的地方1

PHP实现谷歌短网址服务的API接口调用 ](https://cdn.typecodes.com/2014/03/google_shorturl_api.png)

从上面的测试结果图片可以看出，“长转短”和“短转长”的返回的对象中的成员类似，“短转长”多了一个status成员而已。下面是json格式的视图：

/* 1短网址转长网址 */
{
  "kind": "urlshortener#url",
  "id": "http://goo.gl/F90bfL",
  "longUrl": "http://vfhky.sinaapp.com"
}

/* 2短网址转长网址 */
{
  "kind": "urlshortener#url",
  "id": "http://goo.gl/F90bfL",
  "longUrl": "http://vfhky.sinaapp.com",
  "status": "OK"
}

4 要说明的地方2

上面代码输出的是对象，大家可以直接输出里面的成员，例如输出“短转长”中返回的短网址和长网址

$result = ggUrlAPI(0,'http://goo.gl/F90bfL');
echo $result->id.$result->longUrl.'<br/><br/>';

5 错误响应Error responses

假如输入的数据有误或者其它原因造成接口返回错误数据，那么可以通过错误数据进行调试。谷歌短网址API返回的错误信息包括：a status code(状态码), a human readable message(人工可读的消息), and a list of error details(错误详细列表)。

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "required",
    "message": "Required",
    "locationType": "parameter",
    "location": "resource.longUrl"
   }
  ],
  "code": 400,
  "message": "Required"
 }
}

TypeCodes