सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें
दस्तावेज़ देखें

शुरू करें

SDK से खाते की जाँच और सहेजे गए परिणाम

लागत की जाँच करें, प्रत्येक प्रयास का रिकॉर्ड रखें और अन्य API कॉल के बिना सहेजे गए परिणामों को पढ़ें।

इस पेज पर

शुरू करने से पहले

परियोजना का उपयोग करें, अपने SDK क्विकस्टार्ट से SDK और FLASHDATA_API_KEY स्थापित करें। नीचे एक भाषा चुनें। प्रत्येक नई रन निर्देशिका एक इच्छित खोज का प्रतिनिधित्व करती है; किसी भी अनुरोध करने से पहले मौजूदा डायरेक्टरी स्टॉप का पुन: उपयोग करना।

1. पहुँच और वर्तमान लागत की जाँच करें

सहेजें और अपने SDK के लिए चेक चलाने के लिए। यह अनुमतियों, शेष राशि और एक Google Search की कीमत को पढ़ता है। जारी रखें कि एक्सेस चेक के बाद ही; इन चेकों को भुगतान की गई क्वेरी या आरक्षित क्रेडिट जमा करने की अनुमति नहीं है।

check_access.py
import os
import sys
from flashdata import FlashData, APIError

def main():
    key = os.environ.get("FLASHDATA_API_KEY", "").strip()
    if not key:
        raise RuntimeError("Set FLASHDATA_API_KEY in this terminal.")
    with FlashData(api_key=key) as client:
        access = client.account.access()
        if "google_search" not in access["sources"]:
            raise RuntimeError("This key needs google_search permission.")
        balance = client.account.balance()
        pricing = client.account.pricing(source="google_search", request_count=1)
    price = next((p for p in pricing["prices"]
                  if p["source"] == "google_search" and p["available"]), None)
    cost = price.get("estimatedCredits") if price else None
    if cost is None:
        raise RuntimeError("No current price is available; stop here.")
    available = balance["availableCredits"]
    print(f"Available credits: {available}")
    print(f"One search: {cost} credits")
    if available < cost:
        raise RuntimeError("Insufficient credits. Review Billing.")
    print("Access check passed. No paid query submitted.")

if __name__ == "__main__":
    try:
        main()
    except APIError as error:
        print(f"HTTP {error.status_code}; code={error.code}; "
              f"request_id={error.request_id}; Retry-After={error.retry_after}",
              file=sys.stderr)
        sys.exit(1)
    except Exception as error:
        print(f"{type(error).__name__}: {error}", file=sys.stderr)
        sys.exit(1)
Linux / macOS
.venv/bin/python check_access.py
Windows PowerShell
.\.venv\Scripts\python.exe check_access.py

2. एक नई आउटपुट डायरेक्टरी के साथ भागो

चेक पास होने के बाद इन कार्यक्रमों में से एक चलाएं। यह प्रस्तुत करने से पहले निर्देशिका बनाता है, अनुरोध रिकॉर्ड करता है, फिर जवाब बचाता है। निर्देशिका को विफलता पर रखें: इसे हटा दें या एक नया चयन करने से किसी अन्य बिलेबल क्वेरी की अनुमति मिलती है।

archive_search.py
import json
import os
import sys
from datetime import datetime, timezone
from pathlib import Path
from flashdata import FlashData, APIError, SubmissionUnknownError

def main():
    key = os.environ.get("FLASHDATA_API_KEY", "").strip()
    if not key:
        raise RuntimeError("Set FLASHDATA_API_KEY before running.")
    directory = Path(sys.argv[1] if len(sys.argv) > 1 else "runs/research-001")
    directory.mkdir(mode=0o700, parents=True, exist_ok=False)

    def save(name, value):
        with (directory / name).open("x", encoding="utf-8") as output:
            json.dump(value, output, ensure_ascii=False, indent=2)

    request = {"source": "google_search", "query": "battery recycling research",
               "params": {"num": 5}}
    save("request.json", request)
    save("intent.json", {"state": "dispatching",
                         "startedAt": datetime.now(timezone.utc).isoformat()})
    try:
        with FlashData(api_key=key) as client:
            response = client.google.search(request["query"], **request["params"])
    except (APIError, SubmissionUnknownError) as error:
        detail = {"kind": type(error).__name__}
        if isinstance(error, APIError):
            detail.update(code=error.code, httpStatus=error.status_code,
                          requestId=error.request_id, retryAfter=error.retry_after)
        save("error.json", detail)
        raise RuntimeError("Inspect the saved attempt and History before retrying.") from None
    save("result.json", response)
    if response.get("status") != "done":
        raise RuntimeError("Response saved; inspect its status before proceeding.")
    print("Saved:", directory / "result.json")
    print("Usage:", response.get("usage"))

if __name__ == "__main__":
    try:
        main()
    except Exception as error:
        print(f"{type(error).__name__}: {error}", file=sys.stderr)
        sys.exit(1)
Linux / macOS
.venv/bin/python archive_search.py runs/research-001
Windows PowerShell
.\.venv\Scripts\python.exe archive_search.py runs/research-001

अपेक्षित फाइलें

सफलता सहेजे गए परिणाम पथ और उपयोग को प्रिंट करती है। result.json में status: done होना चाहिए; Google परिणाम results[].organic[] में हैं। एक खाली कार्बनिक सरणी मान्य है। एक रिपोर्ट API या परिवहन त्रुटि error.json को बचाई जाती है; intent.json मूल पूर्व-submission रिकॉर्ड बनी हुई है।

सफल प्रयास
runs/research-001/
  request.json # स्रोत, क्वेरी और पैरामीटर
  intent.json # Attempt start time
  result.json # परिणाम और उपयोग सहित पूर्ण प्रतिक्रिया

3. सहेजे गए आउटपुट को पढ़ें

पार्सिंग, सारांश और UI के लिए result.json पढ़ें। ये कमांड केवल स्थानीय फ़ाइलें इस्तेमाल करती हैं। उसी निर्देशिका में खोज दोबारा चलाने पर नेटवर्क कॉल से पहले ही प्रक्रिया रुक जाती है; यह अलग मशीनों के बीच समन्वय नहीं करती और खोया हुआ सर्वर जवाब वापस नहीं लाती।

स्थानीय रूप से पढ़ें
cat runs/research-001/result.json

क्या करना है एक विफलता के बाद

आपके पास क्या हैअगली कार्रवाई
मौजूदा निर्देशिका / EEXISTअपनी फ़ाइलों का निरीक्षण करना। इस प्रयास से कोई नया प्रश्न नहीं भेजा गया था।
result.json, status: doneपढ़ें और प्रक्रिया को बचाया प्रतिक्रिया। इसके उपयोग को मूल शुल्क की प्राप्ति के रूप में पुन: उपयोग करें।
401 / 403 / 402 के साथ error.jsonनए प्रयास की योजना बनाने से पहले पहुँच, स्रोत अनुमतियां या शेष राशि को ठीक करें।
429 / retryAfterअनुरोध दर को बनाए रखने और कम करने के रूप में प्रतीक्षा करें। एक नई रन डायरेक्टरी चुनने से पहले असफल प्रयास की समीक्षा करें।
अज्ञात प्रस्तुतीकरण / इरादे केवल / लिखने की विफलताकार्य पहले से ही स्वीकार किया जा सकता है। निर्देशिका रखें और एक और क्वेरी भेजने से पहले History या ज्ञात नौकरी ID का निरीक्षण करें।

Async क्लाइंट और पृष्ठभूमि नौकरियों

आवश्यकताउपयोग
एक घटना पाश उत्तरदायी रखेंSDK के ग्राहक / प्रतीक्षा कॉल। एक रियलटाइम क्वेरी अभी भी अपने HTTP प्रतिक्रिया में पूरा करती है।
कॉलिंग प्रक्रिया के निकास के बाद फिर से शुरू करेंएक बार पृष्ठभूमि नौकरी जमा करें, अपने दूरस्थ ID को बचाएं, फिर स्थिति और परिणाम पढ़ें।
एक अनुसूची पर भागोमालिक पहुँच और टिकाऊ अनुप्रयोग रन रिकॉर्ड, या CLI के मौजूदा रन जर्नल का उपयोग करें।
Markdown