เรียกดูเอกสาร
เริ่มต้นใช้งาน
เรียกใช้การค้นหา Google ครั้งแรกและรับผลลัพธ์แบบมีโครงสร้างสำหรับแอปหรือเอเจนต์ AI ของคุณ
เริ่มต้นด้วยเอเจนต์ AI
ส่งพรอมป์ต์นี้ให้เอเจนต์ที่ใช้เทอร์มินัลได้ เอเจนต์จะตั้งค่า FlashData และค้นหาหนึ่งครั้ง
อ่าน https://flashdata.dev/auth.md และทำตามคำแนะนำการตั้งค่า FlashData สำหรับสภาพแวดล้อมนี้ ใช้สิทธิ์เข้าถึงที่มีอยู่ซ้ำ หากยังไม่มี ให้เริ่มทดลองใช้เพียงครั้งเดียวเมื่อมีคุณสมบัติตรงตามเงื่อนไข ค้นหา "battery recycling research" บน Google โดยขอผลลัพธ์ไม่เกินห้ารายการ ส่งกลับชื่อแหล่งข้อมูล URL และเครดิตที่ใช้จริง เก็บข้อมูลรับรองในที่จัดเก็บที่ได้รับการป้องกัน ไม่ใส่ไว้ในแชต หากเข้าถึงไม่ได้ ให้แจ้งขั้นตอนถัดไปแทนการสร้างการทดลองใช้ใหม่
เรียก API ครั้งแรก
ต้องการเขียนโค้ดเองหรือไม่? ทำตามสามขั้นตอนนี้ในเทอร์มินัล
รับคีย์ API
สร้างบัญชี ยืนยันอีเมล และสร้างคีย์ที่มีสิทธิ์ Google Search หากมีคีย์ที่เหมาะสมอยู่แล้วให้ใช้คีย์เดิม
รันในเทอร์มินัลแล้ววางคีย์เมื่อระบบขอ โดยข้อความที่ป้อนจะถูกซ่อน ข้ามขั้นตอนนี้หากตั้งค่า FLASHDATA_API_KEY แล้ว
ตั้งค่าคีย์# 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ตั้งค่าคีย์# 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 flashdataSecureKeyเรียกใช้การค้นหา
เลือกภาษาและรันตัวอย่างในเทอร์มินัลเดิม การรันแต่ละครั้งจะส่งการค้นหาหนึ่งครั้ง
Python 3.10+ · บันทึกตัวอย่างเป็น quickstart.py
ติดตั้งpython -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))เรียกใช้python quickstart.pyNode.js 22.18+ · เริ่มในโฟลเดอร์ว่างและบันทึก quickstart.mts
ตั้งค่าnpm 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));เรียกใช้node quickstart.mtsNode.js 22+ · เริ่มในโฟลเดอร์ว่างและบันทึก quickstart.mjs
ตั้งค่าnpm 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));เรียกใช้node quickstart.mjsGo 1.25+ · เริ่มในโฟลเดอร์ว่างและบันทึก main.go ข้าม go mod init หากมีโมดูลอยู่แล้ว
ตั้งค่าgo 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) } }เรียกใช้go run .ไม่ต้องใช้ SDK เรียกใช้คำสั่ง Bash / cURL 7.76+ หรือคำสั่ง 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 20ตรวจสอบผลลัพธ์
คำตอบที่สำเร็จมี status: done แหล่งข้อมูลอยู่ใน results[].organic และเครดิตที่คิดค่าบริการอยู่ใน usage.credits
ตัวอย่างการตอบกลับ (ย่อ){ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }
ลองใช้คอนโซล
- สร้างบัญชีหรือเข้าสู่ระบบ ยืนยันอีเมลและทำตามขั้นตอนตั้งค่าบัญชีที่แสดงในคอนโซล
- เปิด Google Search เลือกแหล่งข้อมูล Google Search และโหมด Realtime แล้วป้อน battery recycling research ขยาย Additional parameters และตั้งค่า Page size (num) เป็น 5
- ตรวจสอบคำขอที่แสดงและเครดิตที่มี แล้วค้นหาหนึ่งครั้ง
- ตรวจสอบคำตอบและการใช้งาน เปิดแหล่งข้อมูลที่ได้รับเพื่อตรวจสอบเนื้อหาก่อนอ้างอิงข้อมูลที่เกินกว่าข้อความตัวอย่าง
ต่อยอดจากผลลัพธ์แรก
หากคำขอแรกไม่สำเร็จ
- ไม่ได้ตั้งค่า FLASHDATA_API_KEY
- ตั้งค่าคีย์ในเทอร์มินัลหรือรันไทม์เดียวกับตัวอย่าง ตัวอย่างเหล่านี้ไม่อ่านไฟล์ .env
- 401 / 403
- ตรวจสอบว่าคีย์หรือการเชื่อมต่อยังใช้งานอยู่และมีสิทธิ์ google_search
- 402
- ตรวจสอบเครดิตที่ใช้ได้ใน Billing หากต้องการสิทธิ์ของเจ้าของบัญชี ให้เชื่อมโยงการทดลองใช้เดิมกับบัญชี
- 429
- ปฏิบัติตาม Retry-After ใช้ตัวตนและหลักฐานการลงทะเบียนเดิม อย่าสร้างการทดลองใช้อีกบัญชี
- หมดเวลาหรือไม่ทราบสถานะการส่ง
- ตรวจสอบการรันเดิมก่อนลองอีกครั้ง ผู้ใช้ CLI ต้องเก็บโปรไฟล์และ ID การรันเดิม ส่วนผู้ใช้ SDK/API ต้องบันทึก ID งานหรือคำขอที่ได้รับ