Semak dokumentasi
Mula di sini
Instal Go SDK dan jalankan permintaan Google Search yang diketik. Kemudian, coba data YouTube dengan klien yang sama.
Pasang SDK
Kemudi membutuhkan Go 1.25+. Pilih proyek baru atau install di direktori yang berisi go.mod yang telah ada.
Pasangmkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Pasanggo get github.com/flashdatadev/[email protected]Autentifikasi
Daftarkan, periksa email Anda dan buat kunci API dengan izin Google Search, atau gunakan kembali kunci yang berwenang.
Tetapkan FLASHDATA_API_KEY di bawah ini, atau jaga nilai yang sudah diberikan oleh lingkungan Anda. Contoh yang membacanya secara eksplisit; berkas .env tidak dimuat.
Prompt kunci tersembunyi · 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_KEYPrompt kunci tersembunyi · 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 flashdataSecureKeyJalankan carian
Simpan ini sebagai main.go di samping go.mod, kemudian jalankan di terminal yang sama. Ini mengirim satu pencarian sampai lima hasil dan mencetak respon 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) } }Jalankango run .Semak hasil
Cari status: done dalam cetakan JSON. Anda menggunakan gelar yang dikembalikan, URLs dan snippet dalam aplikasi atau agen Anda. Daftar organik kosong juga merupakan hasil yang valid.
Contoh output{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- Selesai berarti pencarian selesai.
results[].organic[]- Hasil pencarian histories dengan title, link dan snippet fields.
usage.credits- Kredit kredit yang digunakan oleh permintaan ini. Hasil kelima adalah satu pencarian, bukan lima permintaan.
Coba sumber data lain
Di main.go, hanya mengganti hasil, kesalahan := client.Google.Search(...) panggilan dengan salah satu panggilan ini. Tetap menjaga klien, konteks, pemeriksaan kesalahan dan output JSON, kemudian jalankan lari . lagi. Setiap larian mengajukan satu permintaan baru.
Perlu izin google_news. Ajukan kembali hasil berita untuk pertanyaan Anda.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Perlu izin youtube_metadata. AWAS Mengembalikan rincian video seperti judul, saluran dan durasi; tidak mengunduh video.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Perlu izin youtube_transcript. KANTOR meminta transkrip bahasa Inggris yang sudah ada, termasuk trek otomatis. AWAS Kembali teks dan timestamps ketika trek yang tersedia.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})Apa yang didukung Go SDK
Google- \"Zoby Search, News, Images, Shopping, Video dan Tempat\". Use Google.Pages untuk hasil yang dipinta.
YouTube- Aerophine, Metadata, Transcript, Captions, Channel dan Saran menyediakan data video terstruktur.
YouTube.Download- Kirimkan pekerjaan pengiriman audio atau video ke penyimpanan awan Anda. Kemudia memerlukan izin dan konfigurasi penyimpanan youtube_download; gunakan contoh lengkap di bawah ini.
Jobs / Bulk- Serah dengan pembantu Async, simpan pekerjaan ID, kemudian gunakan Jobs.Wait dan Jobs.Result. Bulk menangani set data yang lebih besar dan pekerjaan yang dapat disambung.
Account- Bacalah identitas, keseimbangan, harga, batas dan penggunaan sebelum pekerjaan yang tidak diinginkan. Anda menggunakan kembali klien yang sama dan kunci yang sah.
WithFormat- Permintaan JSON, teks biasa atau Markdown dengan pilihan format eksplisit. Markdown Format nutfah diambil data untuk agen Anda; aplikasi Anda memasok panggilan model atau jumlah.
Jenis Go
googleSearchInput menjelaskan pertanyaannya. Parameter pilihan yang menggunakan penunjuk, seperti flashdata.Ptr(int64(5)). Hasil Hasil TOW berisi sumber JSON; gunakan DecodeResults[GoogleSearchPayload] ketika Anda membutuhkan medan yang diketik.
Langkah - langkah selanjutnya
Jika langkah gagal
- Paket atau runtime hilang
- Periksa versi go dan jalankan pergi masuk ke dalam direktori yang berisi go.mod.
- 401 / FLASHDATA_API_KEY
- Tetapkan kunci valid di terminal di mana Anda menjalankan contoh.
- 403
- Hidupkan Google Search untuk kunci API ini.
- 402
- Cek Billing untuk kredit yang tersedia, atau klaim pengadilan agen yang kelelahan.
- 429
- Wait untuk Retry-After, kemudian mengurangi permintaan Anda.
- Kehabisan atau server error
- Periksa History sebelum resending; permintaan pertama mungkin sudah berjalan.