Golang 支持 Facebook Graph API 开发的插件库 facebook 的使用

这是一个完全支持 Facebook Graph API 的 Go 语言包，包含文件上传、批量请求和营销 API 功能。它可以在 Google App Engine 中使用。

安装

如果启用了 go mod，使用以下命令安装：

go get github.com/huandu/facebook/v2

如果没有启用 go mod，使用以下命令获取最新主分支版本：

go get -u github.com/huandu/facebook

快速开始

以下是一个读取我的 Facebook 名字的示例：

package main

import (
    "fmt"
    fb "github.com/huandu/facebook/v2"
)

func main() {
    res, _ := fb.Get("/538744468", fb.Params{
        "fields": "first_name",
        "access_token": "a-valid-access-token",
    })
    fmt.Println("Here is my Facebook first name:", res["first_name"])
}

res 的类型是 fb.Result（即 map[string]interface{}）。这个类型有几个有用的方法可以安全地将 res 解码为任何 Go 类型。

// 将 "first_name" 解码为 Go 字符串
var first_name string
res.DecodeField("first_name", &first_name)
fmt.Println("Here's an alternative way to get first_name:", first_name)

// 也可以将整个结果解码到预定义的结构体中
type User struct {
    FirstName string
}

var user User
res.Decode(&user)
fmt.Println("print first_name in struct:", user.FirstName)

使用有效访问令牌读取用户对象

res, err := fb.Get("/me/feed", fb.Params{
     "access_token": "a-valid-access-token",
})

if err != nil {
    // err 可能是 Facebook API 错误
    if e, ok := err.(*Error); ok {
        fmt.Printf("facebook error. [message:%v] [type:%v] [code:%v] [subcode:%v] [trace:%v]",
            e.Message, e.Type, e.Code, e.ErrorSubcode, e.TraceID)
        return
    }

    // err 也可能是当 Facebook API 返回非 JSON 消息时的解码错误
    if e, ok := err.(*UnmarshalError); ok {
        fmt.Printf("facebook error. [message:%v] [err:%v] [payload:%v]",
            e.Message, e.Err, string(e.Payload))
        return
    }

    return
}

// 读取我的最新动态
fmt.Println("My latest feed story is:", res.Get("data.0.story"))

使用 App 和 Session

在生产环境中，建议使用 App 和 Session。它们提供了对所有 API 调用的更多控制，也可以使代码更清晰简洁。

// 创建一个全局 App 变量来保存 app id 和 secret
var globalApp = fb.New("your-app-id", "your-app-secret")

// Facebook 在解析签名请求时需要有效的重定向 URI
globalApp.RedirectUri = "http://your.site/canvas/url/"

// 从签名请求创建新会话
session, _ := globalApp.SessionFromSignedRequest(signedRequest)

// 如果有其他方式获取解码后的访问令牌，可以直接从令牌创建会话
session := globalApp.Session(token)

// 验证访问令牌
err := session.Validate()

// 使用新会话发送带访问令牌的 API 请求
res, _ := session.Get("/me/feed", nil)

发送批量请求

params1 := Params{
    "method": fb.GET,
    "relative_url": "me",
}
params2 := Params{
    "method": fb.GET,
    "relative_url": uint64(100002828925788),
}
results, err := fb.BatchApi(your_access_token, params1, params2)

if err != nil {
    // 检查错误...
    return
}

// batchResult1 和 batchResult2 是对 params1 和 params2 的响应
batchResult1, _ := results[0].Batch()
batchResult2, _ := results[1].Batch()

// 使用解析结果
var id string
res := batchResult1.Result
res.DecodeField("id", &id)

// 使用响应头
contentType := batchResult1.Header.Get("Content-Type")

在 Google App Engine 中使用

Google App Engine 提供了 appengine/urlfetch 包作为标准 HTTP 客户端包。因此，net/http 中的默认客户端无法工作。必须明确设置 Session 中的 HTTP 客户端。

import (
    "appengine"
    "appengine/urlfetch"
)

// 假设这是初始化好的 AppEngine 上下文
var context appengine.Context

// 创建会话并分配特殊客户端
seesion := globalApp.Session("a-access-token")
session.HttpClient = urlfetch.Client(context)

// 现在会话使用 AppEngine HTTP 客户端
res, err := session.Get("/me", nil)

选择 Graph API 版本

// 更改全局默认版本
fb.Version = "v3.0"

// 也可以为每个会话指定版本
session := &fb.Session{}
session.Version = "v3.0" // 覆盖全局默认

启用 appsecret_proof

globalApp := fb.New("your-app-id", "your-app-secret")

// 为所有会话启用 "appsecret_proof"
globalApp.EnableAppsecretProof = true

// 此会话中的所有调用都是安全的
session := globalApp.Session("a-valid-access-token")
session.Get("/me", nil)

// 也可以按会话启用/禁用此功能
session.EnableAppsecretProof(false)

调试 API 请求

fb.Debug = fb.DEBUG_ALL

res, _ := fb.Get("/me", fb.Params{"access_token": "xxx"})
debugInfo := res.DebugInfo()

fmt.Println("http headers:", debugInfo.Header)
fmt.Println("facebook api version:", debugInfo.FacebookApiVersion)

监控 API 使用信息

res, _ := fb.Get("/me", fb.Params{"access_token": "xxx"})
usageInfo := res.UsageInfo()

fmt.Println("App level rate limit information:", usageInfo.App)
fmt.Println("Page level rate limit information:", usageInfo.Page)
fmt.Println("Ad account rate limiting information:", usageInfo.AdAccount)
fmt.Println("Business use case usage information:", usageInfo.BusinessUseCase)

与 golang.org/x/oauth2 包一起使用

import (
    "golang.org/x/oauth2"
    oauth2fb "golang.org/x/oauth2/facebook"
    fb "github.com/huandu/facebook/v2"
)

// 获取 Facebook 访问令牌
conf := &oauth2.Config{
    ClientID:     "AppId",
    ClientSecret: "AppSecret",
    RedirectURL:  "CallbackURL",
    Scopes:       []string{"email"},
    Endpoint:     oauth2fb.Endpoint,
}
token, err := conf.Exchange(oauth2.NoContext, "code")

// 创建客户端管理访问令牌生命周期
client := conf.Client(oauth2.NoContext, token)

// 在会话中使用 OAuth2 客户端
session := &fb.Session{
    Version:    "v2.4",
    HttpClient: client,
}

// 使用会话
res, _ := session.Get("/me", nil)

使用 Context 控制超时和取消

// 创建新上下文
ctx, cancel := context.WithTimeout(session.Context(), 100 * time.Millisecond)
defer cancel()

// 使用 ctx 调用 API
result, err := session.WithContext(ctx).Get("/me", nil)

注意事项

1. 不包含 OAuth 集成。此包仅提供 API 来解析/验证 OAuth 2.0 认证过程中生成的访问令牌和代码。
2. 不支持旧的 RESTful API 和 FQL。这些 API 已被弃用多年。