Duyệt tài liệu
Bắt đầu
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.
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 đặtmkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Cài đặtgo get github.com/flashdatadev/[email protected]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_KEYPhím ẩn nhắc điều · PowerShell# PowerShell 7: paste the key into a hidden prompt. $flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString $env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password Remove-Variable flashdataSecureKeyChạ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.gopackage 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ạygo run .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.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Yêu cầu sự cho phép của youtube_metadata. Trả lại những chi tiết như tiêu đề, kênh và khoảng thời gian; nó không tải video về.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Yêu cầu sự cho phép của youtube_transcript. Yêu cầu bản sao tiếng Anh đã có, bao gồm cả dấu vết tự động. Trở lại nhãn thời gian khi có thể.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})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.