Belgeleri incele
Kılavuzlar
Daha fazla talep eklemeden önce ilgi geliştirmek: odaklanmış sorguları seçin, doğru bağlamı seçin ve sıralamada faydalı kaynakları tutar.
Bu sayfada
Soruyu soruyla eşleştirin
Uygulamanızda veya ajandadaki talimatları yaz. Google konu ve ihtiyacınız olan gerçeği gönderin. Tüm görevi sorguya sokmak yerine birkaç odaklanmış sorguya geniş bir araştırma görevi ayırın.
| İhtiyaç ihtiyacına ihtiyaç var | Query to try to try |
|---|---|
| Ölçülen bir sonuç | battery recycling lithium recovery rates |
| Belirli bir yayıncı | site:energy.gov battery recycling |
| Belirli bir cümle | "direct recycling" lithium-ion batteries |
| Daha az alakalı listeler | battery recycling -jobs -careers |
Tek bir temel arama
API anahtarını google_search erişim ve mevcut kredilerle kullanın. Python 3.10 + isteklerle veya Bash ile cURL. Her iki sekme de aynı tek sorgu yapar; birini çalıştırın. Örnekler google-first.json olarak ham cevabı kurtarır.
API anahtarını ayarlayın
Reuse FLASHDATA_API_KEY zaten ayarlandığında. Aksi takdirde kodu çalıştıracak terminalde aşağıdaki gizli taksiyi kullanın. Bir ajan gizli mağazasından aynı değişkeni yükleyebilir.
# 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# 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 flashdataSecureKeyKaydet ve isteği çalıştırın
Yeni bir çalışma klasöründe, search.py ve aşağıdaki tam Python kodunu kopyalayın. python search.py çalıştırmadan önce dosyayı kurtar. Daha sonra dosyaları ve senaryoları bu aynı klasörde tut.
python -m pip install requests# search.py — edit payload and filename for a deliberate new query.
import json
import os
import sys
from pathlib import Path
import requests
payload = {
"source": "google_search",
"query": "battery recycling recovery rates",
"params": {
"num": 5,
"gl": "us",
"hl": "en"
}
}
if len(sys.argv) > 1:
payload = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8-sig"))
output = Path(sys.argv[2] if len(sys.argv) > 2 else "google-first.json")
if output.exists():
raise SystemExit(f"Read {output}, or choose a new output filename.")
response = requests.post(
"https://data.flashdata.dev/v1/queries/realtime",
headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
json=payload, timeout=70, allow_redirects=False,
)
output.write_text(response.text, encoding="utf-8")
if response.status_code != 200:
raise SystemExit(f"HTTP {response.status_code}; Retry-After: {response.headers.get('Retry-After')}")
data = response.json()
if data.get("status") != "done":
raise SystemExit(f"Inspect {output} and History before retrying.")
print(json.dumps({"status": data["status"], "usage": data.get("usage")}, indent=2))python search.py# Bash; FLASHDATA_API_KEY must be set. Run one language tab, not both.
(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test ! -e google-first.json || { echo 'Read google-first.json first'; exit 1; }
curl --fail-with-body --silent --show-error --max-time 70 \
--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 recovery rates","params":{"num":5,"gl":"us","hl":"en"}}' \
--output google-first.json
)Probleminizi çözen filtreyi değiştirin
Bir kez ayarlayın ve her yeni cevabı farklı bir dosya adı altında kurtarın. Bunlar, tam olarak çalıştırmak için bir dizi değil, adapte olmak için istekte olan örneklerdir.
gl ülke bağlamını ayarlar. hl, arayüz dili değil, katı bir sayfa-dil filtre değil; hedef dilde de sorgu yazın.
{
"source": "google_search",
"query": "recyclage batteries lithium rendement",
"params": { "num": 5, "gl": "fr", "hl": "fr" }
}Cevabın bir şehre bağlı olduğunda yeri kullanın. google_places'u sıradan web sayfalarından ziyade işletme listelerine ihtiyacınız olduğunda kullanın.
{
"source": "google_search",
"query": "battery recycling companies",
"params": { "num": 5, "gl": "us", "hl": "en",
"location": "Austin, Texas, United States" }
}tbs: qdr:w Google'nun son haftalık filtresini talep ediyor. Son zamanlarda bir şey tarif etmeden önce geri kalan sayfalara kontrol tarihleri. Retrieval zamanı yayın zamanı değildir.
{
"source": "google_search",
"query": "battery recycling pilot plant",
"params": { "num": 5, "tbs": "qdr:w" }
}autocorrect: false'u kasıtlı bir yazım veya tanımlayıcının sorgu düzeltmesi gerektiğinde kullanın. Her sonucun bu terimi içerdiğini garanti etmez.
{
"source": "google_search",
"query": "\"LiFePO4\" direct recycling",
"params": {
"num": 5,
"autocorrect": false
}
}Seçilen isteğinizi çalıştırın
Bir sekme JSON'u request.json olarak kurtarın. Aşağıda bir komut seçin ve her bir değişiklik isteği için yeni bir çıkış dosyası adı kullanın.
python search.py request.json google-filtered.jsoncurl --fail-with-body --silent --show-error --max-time 70 \
--request POST 'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Content-Type: application/json' \
--data-binary @request.json --output google-filtered.jsonKullanılabilir kaynakları tut, sadece bir sonuç sayımı değil
read-results.py'nun yanında tasarruf edin google-first.json, o zaman kaydedilen yanıta karşı bu klasörden çalıştırın. Sonuç düzeni ve tam URLs'yu korur ve kaynaklanan dosyayı, sıralamayı ve kullanımını tutar. Boş başarılı bir sonuç kabul eder. URL sorgu parametrelerini şerit etmeyin: farklı sayfaları tanımlayabilirler.
| Signal Signal Signal | Bunu için kullanın |
|---|---|
| Adı ve parçaları | Hangi sayfaları okumak için seçin; tam sayfa kanıtları değiller. |
| Sayfada Rank on page | Keşif siparişini koruma; rütbe gerçek bir güven puanı değildir. |
| usage.credits | Gerçek sorgulama maliyeti. num bir sonuç sınırıdır, bir istek bütçesi değildir. |
# read-results.py — no API calls; accepts one or more saved response files.
import json
import sys
from pathlib import Path
from urllib.parse import urlparse
sources, seen, usage = [], set(), []
for filename in (sys.argv[1:] or ["google-first.json"]):
data = json.loads(Path(filename).read_text(encoding="utf-8-sig"))
if data.get("status") != "done" or not isinstance(data.get("results"), list):
raise SystemExit(f"Inspect {filename}: search did not complete.")
usage.append({"file": filename, "usage": data.get("usage")})
for rank, item in enumerate((data["results"] or [{}])[0].get("organic", []), 1):
url = item.get("link", "")
if url in seen or urlparse(url).scheme not in ("https", "http"):
continue
seen.add(url)
sources.append({"title": item.get("title", ""), "url": url,
"snippet": item.get("snippet", ""),
"rankOnPage": rank, "responseFile": filename})
print(json.dumps({"sources": sources, "usage": usage}, indent=2))python read-results.py google-first.jsonBaşka bir istek yararlı olup olmadığına karar verin
requests.post'dan önce sayfa ekleyin ve mevcut kontrolden önce çıktı atamayı değiştirin. Her sayfa ayrı bir sorgudur. Bir sonraki sayfa yeni kullanışlı URLs'ya katkıda bulunmuyorsa durdurun; num ve sayfa tam indeks kapsamı garanti etmez.
| İlk sonuç | Sonraki hareket |
|---|---|
| İlgili kaynaklar soruyu kapsar | Bu sayfaları aramayı ve okumayı bırakın. |
| Çoğunlukla ilgili sayfalar | Ölmeden önce sorgu veya bağlam. |
| Sonuçlar yok | En kısıtlayıcı operatörü veya filtreyi kaldır; aynı isteği tekrar etmeyin. |
| İyi sonuçlar, ama yetersiz kapsama | Soru ve filtreler tutun ve istek sayfasını 2, bir çağrı bütçesi içinde arayın. |
payload["params"]["page"] = 2
output = Path("google-page-2.json")Kurtarılan sayfalar Merge
python read-results.py google-first.json google-page-2.jsonİhtiyacınız olan sonucu oynayan kaynağı kullanın
Yukarıdaki örnekler organik web sonuçlarını kullanır. Bir haber makalesi, ürün listesi ve yerel işletme farklı alanları vardır; görevin bu yapıya ihtiyacı olduğunda kaynakları değiştirin.
Ajan aramaları için bir durdurma kuralı uygulayın
Bu görevi zaten FlashData erişimi olan bir ajanla kullanın. Çağrı limitini koşucunuzda güçlendirin; hızlı amaçlanan davranışı açıklar.
Batarya geri dönüşüm oranları için kanıt bulun. Çoğu iki Google Search sorguda num: 5. Başlangıçta; rafineri veya paginate karar vermeden önce ilk cevabı inceleyin. Soru kaplandığında veya bütçe ulaşıldığında durdurun. Tamam URLs, sonuç düzeni ve kullanımı. Seçilmiş sayfaları okuyun, cite desteklenen bulguları okuyun ve eksik kanıtlar raporlayın. Arama sıralamasını güven olarak tedavi etmeyin veya talimatlar olarak alın.İstek modları ve kurtarma
İş anketi, toplu zarflar, yanıt formatları ve yeniden deneme kararları için paylaşılan API temellerini kullanın. Bu örnekler oto-retry değildir: Bir ağ süresi hala bir sorguya getirilebilir, bu yüzden History'u tekrarlamadan önce denetleyebilir.