Belgeleri incele
Başlarken
İlk Google aramanızı çalıştırın ve uygulamanız veya yapay zekâ ajanınız için yapılandırılmış sonuçlar alın.
Yapay zekâ ajanınızla başlayın
Bu istemi terminal erişimi olan bir ajana verin. Ajan FlashData’yı kurar ve bir arama çalıştırır.
https://flashdata.dev/auth.md adresini okuyun ve bu ortam için FlashData kurulum adımlarını izleyin. Mevcut erişimi yeniden kullanın; erişim yoksa ve koşulları karşılıyorsanız yalnızca bir deneme başlatın. Google’da "battery recycling research" ifadesini en fazla beş sonuçla arayın. Kaynak başlıklarını, URL’leri ve gerçekten kullanılan kredileri döndürün. Kimlik bilgilerini sohbette değil, korumalı depolamada tutun. Erişim engellenirse başka bir deneme oluşturmak yerine gereken sonraki adımı bildirin.
İlk API çağrınızı yapın
Kodu kendiniz mi yazmak istiyorsunuz? Terminalde bu üç adımı izleyin.
API anahtarı alın
Hesap oluşturun, e-postanızı doğrulayın ve Google Search izni olan bir anahtar oluşturun. Böyle bir anahtarınız varsa yeniden kullanın.
Terminalde çalıştırın ve anahtarı gizli giriş istemine yapıştırın. FLASHDATA_API_KEY zaten ayarlıysa bu adımı atlayın.
Anahtarınızı ayarlayın# 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_KEYAnahtarınızı ayarlayın# 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
Bir dil seçin ve örneği aynı terminalde çalıştırın. Her çalıştırma bir arama gönderir.
Python 3.10+ · Örneği quickstart.py olarak kaydedin.
Yüklepython -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))Çalıştırpython quickstart.pyNode.js 22.18+ · Boş bir klasörde başlayın ve quickstart.mts dosyasını kaydedin.
Yapılandırnpm 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));Çalıştırnode quickstart.mtsNode.js 22+ · Boş bir klasörde başlayın ve quickstart.mjs dosyasını kaydedin.
Yapılandırnpm 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));Çalıştırnode quickstart.mjsGo 1.25+ · Boş bir klasörde başlayın ve main.go dosyasını kaydedin. Mevcut modülde go mod init adımını atlayın.
Yapılandırgo 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) } }Çalıştırgo run .SDK gerekmez. Bash / cURL 7.76+ veya PowerShell 7 komutunu çalıştırın.
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 20Sonucu kontrol edin
Başarılı yanıtta status: done bulunur. Kaynaklar results[].organic, kullanılan krediler ise usage.credits alanındadır.
Örnek yanıt (kısaltılmış){ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }
Konsolu deneyin
- Hesap oluşturun veya oturum açın. E-posta doğrulamasını ve konsolda gösterilen hesap kurulum adımlarını tamamlayın.
- Google Search sayfasını açın, Google Search kaynağını ve Realtime modunu seçip battery recycling research yazın. Additional parameters bölümünü açın ve Page size (num) değerini 5 yapın.
- Gösterilen isteği ve kullanılabilir kredileri kontrol edip aramayı bir kez çalıştırın.
- Yanıtı ve kullanımı inceleyin. Alıntının ötesinde bir bilgiyi kaynak göstermeden önce dönen kaynağı açıp içeriğini kontrol edin.
İlk sonuçtan devam edin
İlk istek başarısız olursa
- FLASHDATA_API_KEY eksik
- Anahtarı örneğin çalıştığı terminalde veya çalışma ortamında ayarlayın. Bu örnekler .env dosyalarını yüklemez.
- 401 / 403
- Anahtarın veya bağlantının etkin olduğunu ve google_search izni bulunduğunu kontrol edin.
- 402
- Billing bölümünde kullanılabilir kredileri kontrol edin. Hesap sahibi erişimi gerekiyorsa mevcut denemeyi hesabınıza bağlayın.
- 429
- Retry-After değerine uyun. Aynı kimliği ve kayıt kanıtını koruyun; başka bir deneme oluşturmayın.
- Zaman aşımı veya gönderim durumu bilinmiyor
- Yeniden denemeden önce mevcut çalıştırmayı inceleyin. CLI kullanıcıları aynı profili ve çalıştırma kimliğini korumalı; SDK/API kullanıcıları döndürülen iş veya istek kimliğini kaydetmelidir.