A Facebook Graph API SDK 使用指南

本文档旨在帮助用户安装和使用基于 Go 语言的 Facebook Graph API SDK。以下内容将详细介绍如何安装 SDK，使用方法，API 文档以及安装方式。

1. 安装指南

在启用 go mod 的情况下，可以使用以下命令安装此包：

go get github.com/huandu/facebook/v2

如果未启用 go mod，请使用以下命令获取最新版本：

go get -u github.com/huandu/facebook

请注意，自 go1.14 版本开始，不兼容的版本默认不会被包含，除非明确指定。因此，建议将导入路径升级为 github.com/huandu/facebook/v2，以避免潜在的依赖错误。

2. 项目使用说明

快速入门

以下是一个示例，通过用户 ID 获取 Facebook 的名字：

package main

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

func main() {
    res, _ := fb.Get("/538744468", fb.Params{
        "fields": "first_name",
        "access_token": "有效的访问令牌",
    })
    fmt.Println("我的 Facebook 名字是:", res["first_name"])
}

读取用户对象

使用有效的访问令牌读取 Graph API 中的 user 对象：

res, err := fb.Get("/me/feed", fb.Params{
    "access_token": "有效的访问令牌",
})

if err != nil {
    // 错误处理
    return
}

// 读取最新的动态故事
fmt.Println("我最新的动态故事是:", res.Get("data.0.story"))

使用 App 和 Session

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

// 创建全局 App 变量，用于存储应用 ID 和密钥
var globalApp = fb.New("你的应用ID", "你的应用密钥")

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

// 创建一个客户端，该客户端包含 Facebook 签名请求字符串作为查询参数
// 这将从签名请求返回一个新的会话
session, _ := globalApp.SessionFromSignedRequest(signedRequest)

3. 项目 API 使用文档

API 文档可以在 Godoc 上找到。

4. 项目安装方式

项目的安装方式已在“安装指南”部分中详细说明。根据您的 go mod 设置，可以使用 go get 命令获取相应的版本。

请按照以上指南操作，以顺利安装和使用 A Facebook Graph API SDK。如果在使用过程中遇到任何问题，请随时创建一个 Issue 或发送一个 Pull Request。我们将尽力回复。