เรียกดูเอกสาร
เริ่มต้นใช้งาน
ติดตั้ง Go SDK และประมวลผลแบบพิมพ์ Google Search ขอล่ะ งั้นลอง YouTube ข้อมูลที่มีลูกค้าคนเดียวกัน
ติดตั้ง SDK
ต้องการ Go 1.25+. เลือกโครงการใหม่ หรือติดตั้งในไดเรกทอรีที่มี go.mod อยู่
ติดตั้งmkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]ติดตั้งgo get github.com/flashdatadev/[email protected]การตรวจสอบสิทธิ์
เซ็นกํากับแล้วตรวจสอบอีเมลของคุณและสร้าง API กุญแจพร้อม Google Search อนุญาตหรือใช้กุญแจที่ได้รับอนุญาตอีกครั้ง
ตั้งค่า FLASHDATA_API_KEY ข้าง ล่าง นี้ หรือ รักษา คุณค่า ที่ คุณ มี อยู่ แล้ว โดย สิ่ง แวด ล้อม ของ คุณ. ตัวอย่างการอ่านมันโดยตรง; แฟ้ม.env ยังไม่ได้โหลด
แจ้งเตือนปุ่มซ่อน as 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แจ้งเตือนปุ่มซ่อน as 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 flashdataSecureKeyเรียกใช้การค้นหา
บันทึกนี้เป็น main.go ข้าง go.modแล้วเอาไปใช้ในอาคารเดียวกัน มันส่งหนึ่งการค้นหาถึงห้าผล และพิมพ์การตอบสนอง JSON
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 .ตรวจสอบผลลัพธ์
ค้นหา status: done ในการพิมพ์ JSON. ใช้ชื่อเล่นที่คืนมา URLs และชิ้นส่วนในใบสมัครหรือตัวแทนของคุณ รายการออร์แกนิคว่างเปล่านี้ยังเป็นผลลัพธ์ที่ใช้ได้
ตัวอย่างผลลัพธ์{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- เสร็จสิ้นแล้ว หมายถึงการค้นหาเสร็จสมบูรณ์
results[].organic[]- สืบค้นผลด้วยชื่อเรื่อง, ลิงก์และช่องย่อย
usage.credits- เงิน ที่ ได้ มา จาก คํา ขอ นี้. ห้าผลคือหนึ่งการค้นหา ไม่ใช่ห้าคําขอ
ลองแหล่งข้อมูลอื่น
ใน main.goต้องการจะแทนที่ผลลัพธ์เท่านั้น ให้ผิดพลาด:= client.Google.Search(...) โทรหาด้วยสายหนึ่ง เก็บไคลเอนต์, บริบท, การตรวจสอบข้อผิดพลาดและ JSON ส่งออกแล้วให้ประมวลผลอีกครั้ง แต่ละการทํางานส่งหนึ่งการร้องขอใหม่
ต้องการ google_news อนุญาต ตอบกลับผลการค้นหาของคุณ
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})ต้องการ youtube_metadata อนุญาต คืนรายละเอียดวิดีโอ เช่น ชื่อเรื่อง, ช่อง และระยะเวลา; มันไม่ได้ดาวน์โหลดวิดีโอ
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})ต้องการ youtube_transcript อนุญาต ต้องการสําเนาภาษาอังกฤษที่มีอยู่ รวมทั้งแทร็กเสียงอัตโนมัติ คืนค่าข้อความและเวลากําหนด เมื่อมีเพลงนี้อยู่
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})อะไรกันนี่ Go SDK สนับสนุน
Google- สืบค้น, ข่าว, ภาพ, ร้านค้า, วิดีโอ และสถานที่ต่างๆ ใช้ Google.Pages สําหรับผลการดัดแปลง
YouTube- สืบค้น, ข้อมูลกํากับภาพ, ทรานสคริปต์, คําบรรยาย, ช่องและคําแนะนําจัดทําข้อมูลวิดีโอแบบโครงสร้าง
YouTube.Download- ส่งงานส่งเสียงหรือวิดีโอไปยังที่เก็บเมฆของคุณ ต้องการ youtube_download อนุญาตให้ใช้และบันทึกค่าต่าง ๆ โดยใช้ตัวอย่างที่สมบูรณ์ด้านล่างนี้
Jobs / Bulk- ส่งข้อมูลด้วย Async ผู้ช่วย, บันทึกงาน IDแล้วใช้ Jobs.Wait ถึง Jobs.Result. Bulk จัดการกับชุดข้อมูลขนาดใหญ่และงานที่ใช้งานได้อีกครั้ง
Account- อ่านอัตลักษณ์ ดุลยภาพ ค่านิยม ข้อจํากัด และการใช้งาน ก่อนงานไม่มีกําหนด ใช้ลูกความเดียวกันและกุญแจที่ได้รับอนุญาต
WithFormat- ต้องการ JSONข้อความธรรมดาหรือ Markdown ด้วยตัวเลือกการจัดรูปแบบ Markdown รูปแบบการรับข้อมูลจากตัวแทนของคุณ; การแจ้งรุ่นของโปรแกรมหรือผลรวม
Go ชนิด
Google สืบค้น Input อธิบายคําค้น พารามิเตอร์ทางเลือก ใช้ตัวชี้ เช่น flashdata.Ptr(inT64)5)). ผลลัพธ์มีแหล่ง JSONสืบค้นเมื่อคุณต้องการช่องข้อมูลที่พิมพ์แล้ว
ถัดไป
ถ้าขั้นตอนล้มเหลว
- แพกเกจหรือไม่พบเวลาทํางาน
- Check Go version แล้วเรียกในไดเรกทอรีที่มี go.mod
- 401 / FLASHDATA_API_KEY
- ตั้งค่ากุญแจที่ถูกต้องในเทอร์มินัลที่คุณเรียกใช้งานตัวอย่าง
- 403
- เปิด Google Search สําหรับสิ่งนี้ API กุญแจ
- 402
- ตรวจสอบเครดิตที่ใช้ได้ใน Billing หรือผูกสิทธิ์ทดลองใช้ของเอเจนต์ที่หมดเครดิตแล้วกับบัญชี
- 429
- รอ Retry-After แล้วลดอัตราการร้องขอของคุณ
- หมดเวลาหรือเซิร์ฟเวอร์ผิดพลาด
- ตรวจสอบ History ก่อนจะทําการแก้ไขการร้องขอแรกอาจจะทํางานอยู่แล้ว