Duyệt tài liệu
Bắt đầu
Chạy lượt tìm kiếm Google đầu tiên và nhận kết quả có cấu trúc cho ứng dụng hoặc tác nhân AI của bạn.
Bắt đầu với tác nhân AI
Gửi câu lệnh này cho tác nhân có quyền dùng terminal. Tác nhân sẽ thiết lập FlashData và chạy một lượt tìm kiếm.
Đọc https://flashdata.dev/auth.md và làm theo hướng dẫn thiết lập FlashData cho môi trường này. Tái sử dụng quyền truy cập hiện có; nếu chưa có, chỉ bắt đầu một lần dùng thử khi đủ điều kiện. Tìm "battery recycling research" trên Google với tối đa năm kết quả. Trả về tiêu đề nguồn, URL và tín dụng thực tế đã dùng. Giữ thông tin xác thực trong bộ lưu trữ được bảo vệ, không đưa vào chat. Nếu truy cập bị chặn, hãy báo bước tiếp theo thay vì tạo lần dùng thử khác.
Thực hiện lệnh gọi API đầu tiên
Muốn tự viết mã? Làm theo ba bước sau trong terminal.
Lấy khóa API
Tạo tài khoản, xác minh email rồi tạo khóa có quyền Google Search. Nếu đã có khóa phù hợp, hãy dùng lại.
Chạy trong terminal và dán khóa vào lời nhắc nhập ẩn. Bỏ qua nếu FLASHDATA_API_KEY đã được đặt.
Đặt khóa# 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Đặt khóa# 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
Chọn ngôn ngữ và chạy ví dụ trong cùng terminal. Mỗi lần chạy sẽ gửi một lượt tìm kiếm.
Python 3.10+ · Lưu ví dụ thành quickstart.py.
Cài đặtpython -m pip install "flashdata==1.1.0"quickstart.pyimport json import os from flashdata import FlashData with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client: response = client.google.search("battery recycling research", num=5) if response["status"] != "done": raise RuntimeError(response) print(json.dumps(response, indent=2))Chạypython quickstart.pyNode.js 22.18+ · Bắt đầu trong thư mục trống và lưu quickstart.mts.
Thiết lậpnpm init -y npm install --save-exact @flashdata-dev/[email protected]quickstart.mtsimport { FlashData } from '@flashdata-dev/sdk'; const apiKey = process.env.FLASHDATA_API_KEY; if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.'); const client = new FlashData({ apiKey }); const response = await client.google.search({ query: 'battery recycling research', num: 5, }); if (response.status !== 'done') throw new Error(JSON.stringify(response)); console.log(JSON.stringify(response, null, 2));Chạynode quickstart.mtsNode.js 22+ · Bắt đầu trong thư mục trống và lưu quickstart.mjs.
Thiết lậpnpm init -y npm install --save-exact @flashdata-dev/[email protected]quickstart.mjsimport { FlashData } from '@flashdata-dev/sdk'; const apiKey = process.env.FLASHDATA_API_KEY; if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.'); const client = new FlashData({ apiKey }); const response = await client.google.search({ query: 'battery recycling research', num: 5, }); if (response.status !== 'done') throw new Error(JSON.stringify(response)); console.log(JSON.stringify(response, null, 2));Chạynode quickstart.mjsGo 1.25+ · Bắt đầu trong thư mục trống và lưu main.go. Bỏ qua go mod init nếu mô-đun đã tồn tại.
Thiết lậpgo mod init example.com/flashdata-quickstart go get github.com/flashdatadev/[email protected]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 .Không cần SDK. Chạy lệnh Bash / cURL 7.76+ hoặc lệnh PowerShell 7.
Bash / cURLcurl --fail-with-body --silent --show-error \ --request POST https://data.flashdata.dev/v1/queries/realtime \ --header "X-API-Key: $FLASHDATA_API_KEY" \ --header 'Content-Type: application/json' \ --data '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'PowerShell 7$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' $flashdataResult = Invoke-RestMethod -Method Post -Uri 'https://data.flashdata.dev/v1/queries/realtime' -Headers @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } -ContentType 'application/json' -Body $flashdataRequest $flashdataResult | ConvertTo-Json -Depth 20Kiểm tra kết quả
Phản hồi thành công có status: done. Nguồn nằm trong results[].organic và tín dụng đã tính nằm trong usage.credits.
Phản hồi mẫu (rút gọn){ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }
Thử bảng điều khiển
- Tạo tài khoản hoặc đăng nhập. Hoàn tất xác minh email và các bước thiết lập tài khoản được hiển thị trong bảng điều khiển.
- Mở Google Search, chọn nguồn Google Search và chế độ Realtime, rồi nhập battery recycling research. Mở Additional parameters và đặt Page size (num) thành 5.
- Kiểm tra yêu cầu hiển thị và tín dụng khả dụng, sau đó chạy tìm kiếm một lần.
- Kiểm tra phản hồi và mức sử dụng. Mở nguồn được trả về để xác minh nội dung trước khi trích dẫn thông tin ngoài đoạn trích.
Phát triển từ kết quả đầu tiên
Nếu yêu cầu đầu tiên thất bại
- Thiếu FLASHDATA_API_KEY
- Đặt khóa trong cùng terminal hoặc môi trường chạy ví dụ. Các đoạn mã này không đọc tệp .env.
- 401 / 403
- Kiểm tra khóa hoặc kết nối đang hoạt động và có quyền google_search.
- 402
- Kiểm tra tín dụng khả dụng trong Billing. Liên kết lượt dùng thử hiện có với tài khoản nếu cần quyền của chủ sở hữu.
- 429
- Tuân theo Retry-After. Giữ nguyên danh tính và bằng chứng đăng ký; không tạo lượt dùng thử khác.
- Hết thời gian chờ hoặc chưa rõ trạng thái gửi
- Kiểm tra lần chạy hiện có trước khi thử lại. Người dùng CLI cần giữ nguyên hồ sơ và ID lần chạy; người dùng SDK/API cần lưu ID tác vụ hoặc yêu cầu được trả về.