Belgeleri incele
Başlarken
Go SDK'u yükleyin ve bir tür Google Search isteği çalıştırın. Sonra YouTube verileri aynı müşteri ile deneyin.
Yüklemek için SDK
Go 1.25+'yı gerektirir. Mevcut go.mod içeren dizininde yeni bir proje veya yükleme seçin.
Yüklemkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Yüklego get github.com/flashdatadev/[email protected]Kimlik Doğrulama
Kayıt olun, e-postanızı doğrulayın ve API anahtarını Google Search izni ile doğrulayın veya yetkili bir anahtarı yeniden kullanın.
FLASHDATA_API_KEY aşağıda ayarlayın veya ortamınız tarafından zaten verilen değeri tut. Örnek açıkça okur; .env dosyaları yüklenemez.
Gizli anahtar · 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_KEYGizli anahtar · 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 flashdataSecureKeyArama çalıştırın
Bunu main.go'un yanında go.mod olarak kaydedin, sonra aynı terminalde çalıştırın. Beş sonuç için bir arama gönderir ve JSON yanıtını yazdırır.
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) } }Çalıştırgo run .Sonucu kontrol edin
status: done'ye basılı JSON'ye bakın. Geri kalan başlıkları kullanın, URLs ve parçaları uygulamanızda veya acentenizde kullanın. Boş organik bir liste de geçerli bir sonuçtur.
Örnek çıktı{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- Yapılan arama tamamlandı anlamına gelir.
results[].organic[]- Başlık, bağlantı ve parçaları ile sonuçlar arayın.
usage.credits- Bu istek tarafından kullanılan krediler. Beş sonuç bir arama, beş talep değil.
Başka bir veri kaynağı deneyin
main.go'da, sadece sonucu yerine, err:= client.Google.Search(...) bu çağrılardan biriyle çağrı. Müşteriyi, bağlamı, hata kontrollerini ve JSON çıktısını tut, sonra tekrar koşmaya devam edin. Her işletme yeni bir istek gönderir.
google_news izni gerektirir. Sorunuz için haber sonuçları döndürür.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})youtube_metadata izni gerektirir. Başlık, kanal ve süresi gibi video ayrıntıları döndürür; videoyu indirmez.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})youtube_transcript izni gerektirir. Otomatik parçalar dahil olmak üzere mevcut bir İngilizce transkript talep eder. Bu takip mevcut olduğunda metin ve zaman notları döndürür.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})Go SDK ne destekliyor
Google- Arama, Haberler, Görüntüler, Alışveriş, Videolar ve Yerler. Google.Pages'u paginated sonuçlar için kullanın.
YouTube- Arama, Metadata, Transcript, Captions, Channel ve Öneriler yapılandırılmış video verileri sağlar.
YouTube.Download- Bulut depolamanıza bir ses veya video teslimat işi gönderin. youtube_download izin ve depolama yapılandırması gerektirir; aşağıdaki tam örneği kullanın.
Jobs / Bulk- Bir Async yardımcısı ile gönderin, işi ID'dan kurtarın, sonra Jobs.Wait ve Jobs.Result'u kullanın. Bulk daha büyük veri kümelerini ve yeniden kullanılabilir işleri ele alır.
Account- Kimlik, denge, fiyatlandırma, limitler ve kullanım istenmeyen çalışmadan önce. Aynı müşteriyi yeniden kullanın ve yetkili anahtar.
WithFormat- JSON, düz metin veya Markdown'yu açık format seçenekleri ile talep edin. Markdown formatları ajanınız için veri alır; uygulama malzemeleri model aramalarınız veya özetleriniz.
Go türleri
Google SearchInput sorguyu açıklar. Seçmeli parametreler flashdata.Ptr (int64 (5) gibi işaretleyicileri kullanır. Sonuçlar kaynak JSON içerir; DecodeResults[Google AramaPayload] tipi alanlara ihtiyacınız olduğunda.
Sonraki adımlar
Bir adım başarısız olursa
- Paket veya runtime eksik
- Check go version and run go get in the directory that go.mod.
- 401 / FLASHDATA_API_KEY
- Örnek çalıştırdığınız terminalde geçerli bir anahtar ayarlayın.
- 403
- Enable Google Search Bunun için API anahtar.
- 402
- Kullanılabilir krediler için Billing bölümünü kontrol edin veya tükenmiş ajan denemesini hesaba bağlayın.
- 429
- Retry-After için bekleyin, sonra istek oranını azaltır.
- Zamanout veya sunucu hatası
- History'u tekrarlamadan önce kontrol edin; ilk istek zaten çalıştırılabilir.