Jelajahi dokumentasi
Mulai
Pasang Go SDK dan menjalankan diketik Google Search permintaan. Kemudian coba YouTube data dengan klien yang sama.
Pasang SDK
Membutuhkan Go 1.25 +. Pilih projek baru atau install di direktori yang memuat go.mod yang telah ada.
Instalmkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Instalgo get github.com/flashdatadev/[email protected]Otentikasi
Mendaftar, memverifikasi email Anda dan membuat kunci API dengan izin Google Search, atau gunakan kembali kunci yang berwenang.
Atur FLASHDATA_API_KEY di bawah ini, atau simpan nilai yang sudah disediakan oleh lingkungan Anda. Contoh 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 pencarian
Simpan ini sebagai main.go di samping go.mod, kemudian jalankan di terminal yang sama. Mengirimkan 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 .Periksa hasil
Cari status: done dalam cetak JSON. Gunakan judul yang dikembalikan, URLs dan snippet pada aplikasi atau agen Anda. Daftar organik kosong juga merupakan hasil yang valid.
Contoh keluaran{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- dilakukan berarti pencarian selesai.
results[].organic[]- Hasil pencarian dengan judul, ruas taut, dan snippet.
usage.credits- Kredit yang digunakan oleh permintaan ini. Lima hasil adalah satu pencarian, bukan lima permintaan.
Coba sumber data lain
Dalam main.go, ganti hanya hasilnya, err: = client.Google.Search (...) panggil dengan salah satu panggilan ini. Jaga klien, konteks, pemeriksaan kesalahan dan keluaran JSON, kemudian jalankan go run. lagi. Masing-masing berlari mengajukan satu permintaan baru.
Butuh izin google_news. Mengembalikan hasil berita untuk permintaan Anda.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Butuh izin youtube_metadata. Mengembalikan rincian video seperti judul, saluran, dan durasi; itu tidak mengunduh video.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Butuh izin youtube_transcript. Meminta transkrip bahasa Inggris yang sudah ada, termasuk trek otomatis. Mengembalikan teks dan penanda waktu 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 Go SDK dukungan
Google- Cari, Berita, Gambar, Belanja, Video dan Tempat. Gunakan Google.Pages untuk hasil paginasi.
YouTube- Cari, Metadata, Transkrip, Kapsi, Saluran dan Saran menyediakan data video terstruktur.
YouTube.Download- Kirim audio atau video pengiriman ke penyimpanan awan Anda. Butuh ijin youtube_download dan konfigurasi penyimpanan; gunakan contoh lengkap di bawah ini.
Jobs / Bulk- Kirim bantuan Async, simpan tugas ID, lalu gunakan Jobs.Wait dan Jobs.Result. Bulk menangani dataset yang lebih besar dan pekerjaan yang dapat diresume.
Account- Baca identitas, keseimbangan, harga, batas-batas dan penggunaan sebelum pekerjaan tanpa pengawasan. Gunakan kembali klien yang sama dan kunci yang berwenang.
WithFormat- Permintaan JSON, teks biasa atau Markdown dengan opsi format eksplisit. Format Markdown diambil data untuk agen Anda; aplikasi Anda menyediakan panggilan model atau rangkuman.
Tipe Go
GoogleeSearchInput menjelaskan permintaan tersebut. Parameter opsional menggunakan penunjuk, seperti flashdata.Ptr (int64 (5)). Hasil berisi sumber JSON; gunakan DecodeResults [GoogleSearchpayload] ketika Anda membutuhkan field diketik.
Langkah selanjutnya
Jika satu langkah gagal
- Paket atau waktu jalan hilang
- Periksa versi pergi dan jalankan pergi mendapatkan dalam direktori berisi go.mod.
- 401 / FLASHDATA_API_KEY
- Atur kunci yang valid di terminal di mana Anda menjalankan contoh.
- 403
- Aktifkan Google Search untuk kunci API ini.
- 402
- Periksa Billing untuk kredit yang tersedia, atau klaim kelelahan agen pengadilan.
- 429
- Tunggu Retry-After, kemudian kurangi tingkat permintaan Anda.
- Tenggat waktu atau galat server
- Periksa History sebelum mengirim ulang; permintaan pertama mungkin sudah dijalankan.