दस्तावेज़ देखें
गाइड
अधिक अनुरोध जोड़ने से पहले प्रासंगिकता में सुधार: केंद्रित प्रश्नों का चयन करें, सही संदर्भ निर्धारित करें और रैंक ऑर्डर में उपयोगी स्रोतों को रखें।
इस पेज पर
प्रश्न के लिए क्वेरी मिलान करें
अपने ऐप या एजेंट प्रॉम्प्ट में लिखित निर्देश रखें। Google को उस विषय और उस तथ्य को भेजें जिसकी आपको आवश्यकता है। पूरे कार्य को क्वेरी में चिपकाने के बजाय कुछ केंद्रित प्रश्नों में एक व्यापक शोध कार्य को विभाजित करें।
| आवश्यकता | कोशिश करने के लिए क्वेरी |
|---|---|
| एक मापा परिणाम | battery recycling lithium recovery rates |
| विशेष प्रकाशक | site:energy.gov battery recycling |
| एक विशिष्ट वाक्यांश | "direct recycling" lithium-ion batteries |
| कम अप्रासंगिक लिस्टिंग | battery recycling -jobs -careers |
एक बेसलाइन खोज रन
google_search पहुँच और उपलब्ध क्रेडिट के साथ एक API कुंजी का उपयोग करें। Python 3.10+ को अनुरोधों के साथ चुनें, या Bash के साथ cURL. दोनों ही टैब्स एक ही क्वेरी बनाते हैं; एक को चलाते हैं। उदाहरण google-first.json के रूप में कच्चे प्रतिक्रिया को बचाते हैं।
अपने API कुंजी सेट करें
यदि पहले से ही सेट किया गया है तो FLASHDATA_API_KEY का पुन: उपयोग करें। अन्यथा टर्मिनल में नीचे छिपे हुए संकेत का उपयोग करता है जो कोड चला जाएगा। एक एजेंट अपने गुप्त स्टोर से एक ही चर को लोड कर सकता है।
# 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 flashdataSecureKeyसेव करें और उसे चलाने के लिए अनुरोध
एक नए काम करने वाले फ़ोल्डर में, search.py बनाएं और इसमें नीचे पूरा Python कोड कॉपी करें। python search.py चलाने से पहले फ़ाइल को सहेजें। बाद में इस फ़ोल्डर में फ़ाइलों और स्क्रिप्ट का अनुरोध करें।
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
)फ़िल्टर को बदलें जो आपकी समस्या को हल करता है
एक समय में एक सेटिंग बदलें और एक अलग फ़ाइल नाम के तहत प्रत्येक नई प्रतिक्रिया को बचाओ। ये अनुकूलन करने के लिए अनुरोध-शरीर के उदाहरण हैं, पूर्ण रूप से चलाने के लिए अनुक्रम नहीं।
ग्ल सेट देश संदर्भ. hl सेट इंटरफ़ेस भाषा, एक सख्त पृष्ठ भाषा फ़िल्टर नहीं; अपने लक्ष्य भाषा में भी क्वेरी लिखें।
{
"source": "google_search",
"query": "recyclage batteries lithium rendement",
"params": { "num": 5, "gl": "fr", "hl": "fr" }
}जब उत्तर शहर पर निर्भर करता है तो स्थान का उपयोग करें। जब आपको साधारण वेब पृष्ठों के बजाय व्यावसायिक लिस्टिंग की आवश्यकता होती है तो google_places का उपयोग करें।
{
"source": "google_search",
"query": "battery recycling companies",
"params": { "num": 5, "gl": "us", "hl": "en",
"location": "Austin, Texas, United States" }
}Tbs: qdr: w अनुरोध Google के पिछले सप्ताह फिल्टर। हाल ही में कुछ निर्धारित करने से पहले लौटाए गए पृष्ठों पर तारीखों की जांच करें। पुनर्प्राप्ति समय प्रकाशन समय नहीं है।
{
"source": "google_search",
"query": "battery recycling pilot plant",
"params": { "num": 5, "tbs": "qdr:w" }
}जब एक जानबूझकर वर्तनी या पहचानकर्ता को क्वेरी सुधार से बचना चाहिए तो autocorrect: false का उपयोग करें। यह गारंटी नहीं देता है कि प्रत्येक परिणाम में उस अवधि होती है।
{
"source": "google_search",
"query": "\"LiFePO4\" direct recycling",
"params": {
"num": 5,
"autocorrect": false
}
}अपने चुने हुए अनुरोध को चलाएं
एक टैब के JSON को request.json के रूप में सहेजें। नीचे एक कमांड चुनें और प्रत्येक बदल अनुरोध के लिए एक नया आउटपुट फ़ाइल नाम का उपयोग करें।
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.jsonउपयोग करने योग्य स्रोतों को न केवल एक परिणाम की गिनती
read-results.py को google-first.json के बगल में सहेजें, फिर इसे बचाया जवाब के खिलाफ उस फ़ोल्डर से चलाएं। यह परिणाम आदेश और सटीक URLs को संरक्षित करता है, डुप्लिकेट को हटा देता है, और मूल फ़ाइल, रैंक और उपयोग रखता है। यह एक खाली सफल परिणाम स्वीकार करता है। URL क्वेरी पैरामीटर को स्ट्रिप न करें: वे विभिन्न पृष्ठों की पहचान कर सकते हैं।
| संकेत | इसके लिए उपयोग करें |
|---|---|
| शीर्षक और स्निपेट | कौन से पृष्ठों को पढ़ने के लिए चुनें; वे पूर्ण पृष्ठ के सबूत नहीं हैं। |
| पृष्ठ पर रैंक | खोज आदेश को संरक्षित करें; रैंक एक तथ्यात्मक विश्वास स्कोर नहीं है। |
| usage.credits | वास्तविक क्वेरी लागत रिकॉर्ड करें। संख्या एक परिणाम सीमा है, कोई अनुरोध बजट नहीं है। |
# 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.jsonयह तय करना कि क्या अन्य अनुरोध उपयोगी है?
requests.post से पहले पृष्ठ जोड़ें और अस्तित्व की जांच से पहले आउटपुट असाइनमेंट को प्रतिस्थापित करें। प्रत्येक पृष्ठ एक अलग क्वेरी है। यदि अगले पृष्ठ में कोई नया उपयोगी URLs योगदान नहीं है, तो बंद करो; संख्या और पृष्ठ पूर्ण सूचकांक कवरेज की गारंटी नहीं देता है।
| पहला परिणाम | अगला कदम |
|---|---|
| प्रासंगिक सूत्र प्रश्न को कवर करते हैं | उन पृष्ठों को खोजना और पढ़ना बंद करें। |
| अधिकतर असंबंधित पृष्ठ | पेजिनेटिंग से पहले क्वेरी या संदर्भ को परिष्कृत करें। |
| कोई परिणाम नहीं | सबसे प्रतिबंधित ऑपरेटर या फ़िल्टर निकालें; समान अनुरोध को दोहराना नहीं है। |
| अच्छा परिणाम, लेकिन अपर्याप्त कवरेज | एक कॉल बजट के भीतर क्वेरी और फिल्टर को अपरिवर्तित और अनुरोध पृष्ठ 2 को रखें। |
payload["params"]["page"] = 2
output = Path("google-page-2.json")बचाया पृष्ठों को मर्ज करें
python read-results.py google-first.json google-page-2.jsonउस स्रोत का उपयोग करें जो आपको आवश्यक परिणाम से मेल खाता है
उपरोक्त उदाहरण कार्बनिक वेब परिणाम का उपयोग करते हैं। एक समाचार लेख, उत्पाद सूचीकरण और स्थानीय व्यापार के अलग-अलग क्षेत्र होते हैं; जब कार्य को उस संरचना की आवश्यकता होती है तो स्रोत स्विच करें।
एजेंट खोज के लिए एक रोक नियम लागू करें
इस कार्य का उपयोग एक एजेंट के साथ करें जिसमें पहले से ही FlashData एक्सेस है। अपने धावक में कॉल सीमा को लागू करें; संकेत इच्छित व्यवहार का वर्णन करता है।
बैटरी रीसाइक्लिंग वसूली दरों के लिए सबूत का पता लगाएं। अधिकांश दो Google Search क्वेरीज़ पर नंबर के साथ प्रयोग करें: 5. ध्यान केंद्रित करना शुरू करें; यह तय करने से पहले पहली प्रतिक्रिया का निरीक्षण करें कि क्या परिष्कृत करना है या नहीं। जब प्रश्न को कवर किया जाता है या बजट पहुंच जाता है तो बंद करें। सटीक URLs, परिणाम आदेश और उपयोग को संरक्षित करें। चयनित पृष्ठों को पढ़ें, उद्धृत समर्थन निष्कर्ष, और लापता सबूत की रिपोर्ट करें। खोज रैंक को आत्मविश्वास के रूप में नहीं मानते हैं या निर्देश के रूप में पाठ को पुनः प्राप्त करते हैं।अनुरोध मोड और वसूली
नौकरी मतदान, बैच लिफाफे, प्रतिक्रिया प्रारूपों और रिट्री निर्णयों के लिए साझा API मूल बातें का उपयोग करें। ये उदाहरण ऑटो-रीटरी नहीं हैं: एक नेटवर्क टाइमआउट अभी भी एक क्वेरी जमा कर सकता है, इसलिए इसे दोहराने से पहले History का निरीक्षण करें।