Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Bắt đầu

Go SDK khởi chạy nhanh

Cài đặt Go SDK rồi chạy một kiểu Google Search yêu cầu. Vậy hãy thử dữ liệu YouTube với cùng một khách hàng.

  1. Cài đặt SDK

    Yêu cầu Go 1.25+. Chọn một dự án mới hoặc cài đặt trong thư mục chứa thiết bị đã có go.mod.

    Cài đặt
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. Xác thực

    Đăng ký, kiểm tra email của bạn và tạo ra một API phím với Google Search cho phép, hoặc sử dụng lại một phím được ủy quyền.

    Đặt FLASHDATA_API_KEY Bên dưới, hoặc giữ giá trị đã được môi trường cung cấp. Ví dụ đọc rõ ràng; các tập tin .env chưa được nạp.

    Phím ẩn nhắc điều · Bash
    # Bash: paste the key into a hidden prompt, not into this command.
    read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
    printf '\n'
    export FLASHDATA_API_KEY
  3. Chạy tìm kiếm

    Lưu cái này vào main.go bên cạnh go.modSau đó chạy nó trong cùng một thiết bị cuối. Nó gửi một tìm kiếm lên đến năm kết quả và in các JSON Trả lời đi.

    main.go
    package main
    
    import (
        "context"
        "encoding/json"
        "log"
        "os"
        "time"
    
        flashdata "github.com/flashdatadev/flashdata-go"
    )
    
    func main() {
        key := os.Getenv("FLASHDATA_API_KEY")
        if key == "" {
            log.Fatal("Set FLASHDATA_API_KEY through your server's secret manager.")
        }
        client, err := flashdata.New(flashdata.Options{APIKey: key})
        if err != nil {
            log.Fatal(err)
        }
        ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
        defer cancel()
        result, err := client.Google.Search(ctx, flashdata.GoogleSearchInput{
            Query: "battery recycling research",
            Params: &flashdata.GoogleSearchParams{Num: flashdata.Ptr(int64(5))},
        })
        if err != nil {
            // Do not automatically resubmit an uncertain paid request.
            log.Fatal(err)
        }
        if err := json.NewEncoder(os.Stdout).Encode(result); err != nil {
            log.Fatal(err)
        }
        if result.Status != "done" {
            log.Fatalf("Search did not complete: %s", result.Status)
        }
    }
    Chạy
    go run .
  4. Kiểm tra kết quả

    Tìm status: done in ra JSON. Dùng tên cũ, URLs và chia sẻ trong đơn hoặc tác nhân của bạn. Một danh sách hữu cơ rỗng cũng là một kết quả hợp lệ.

    Đầu ra Ví dụ
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    đã hoàn thành việc tìm kiếm.
    results[].organic[]
    Kết quả tìm kiếm với tiêu đề, liên kết và trường phân mảnh.
    usage.credits
    Các tín dụng được sử dụng bởi yêu cầu này. 5 kết quả là 1 tìm kiếm, không phải 5 yêu cầu.

Thử một nguồn dữ liệu khác

Vào main.go, thay thế chỉ kết quả, sai: = client.Google.Search(...) Gọi với một trong những cuộc gọi này. Giữ khách, ngữ cảnh, kiểm tra lỗi và JSON kết xuất, rồi chạy lại chạy. Mỗi người chạy một yêu cầu mới.

Yêu cầu sự cho phép của google_news. Kết quả báo cáo kết quả cho yêu cầu của anh.

Thay thế cuộc gọi tìm kiếm trong main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

Cái quái gì... Go SDK Hỗ trợ

Google
Tìm kiếm, tin tức, hình ảnh, mua sắm, videos và Places. Dùng Google.Pages cho những kết quả đã qua.
YouTube
Tìm kiếm, siêu dữ liệu, Transcript, Điều khiển, Kênh và gợi ý cung cấp dữ liệu video có cấu trúc.
YouTube.Download
Gửi một công việc chuyển phát âm thanh hay video đến kho lưu trữ đám mây của bạn. Yêu cầu youtube_download Cho phép và cấu hình lưu trữ; hãy dùng ví dụ đầy đủ bên dưới.
Jobs / Bulk
Phục tùng với một Async Trợ giúp, lưu công việc IDsau đó sử dụng Jobs.Wait và Jobs.Result. Bulk xử lý bộ dữ liệu lớn hơn và việc làm có thể tái sử dụng.
Account
Đọc danh tính, số dư, giá trị, giới hạn và sử dụng trước khi làm việc vô trách nhiệm. Hãy tái sử dụng cùng một khách hàng và chìa khóa được ủy quyền.
WithFormat
Yêu cầu JSONVăn bản thường hoặc Markdown với các tùy chọn định dạng rõ ràng. Markdown Định dạng thu thập dữ liệu cho tác nhân của bạn; mô hình ứng dụng cung cấp cuộc gọi hoặc tóm tắt.

Kiểu Go

Google Search Input mô tả truy vấn. Tham số tùy chọn dùng con trỏ, chẳng hạn flashdata.Ptr(int64(Trong năm64)5)). Kết quả chứa mã nguồn JSON; sử dụng DecodeResults [Google find Traveload] khi bạn cần gõ trường.

Bước kế

Nếu một bước không thành công

Gói hoặc chạy thời gian thiếu
Kiểm tra phiên bản và chạy đi vào thư mục chứa go.mod.
401 / FLASHDATA_API_KEY
Đặt một phím hợp lệ trong thiết bị cuối nơi bạn chạy ví dụ.
403
Bật Google Search Vì cái này API Chìa khóa.
402
Kiểm tra Billing hoặc tuyên bố một vụ thử nghiệm tác nhân kiệt sức.
429
Chờ Retry-After, sau đó giảm tốc độ yêu cầu.
Lỗi quá giờ hoặc máy chủ
Kiểm tra History trước khi phục hồi, có lẽ yêu cầu đầu tiên đã chạy rồi.