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

शुरू करें

Python SDK Quickstart

Python SDK स्थापित करें और कुछ लाइनों के कोड के साथ खोज परिणाम प्रिंट करें। तुल्यकालिक और asyncio उदाहरण शामिल हैं।

  1. SDK स्थापित करें

    Python 3.10+ की आवश्यकता है। अपनी परियोजना डायरेक्टरी में इन कमांडों को चलाएं। पहले से ही आभासी वातावरण का उपयोग कर? Flashdata==1.1.0 को उस वातावरण के python-m pip के बजाय स्थापित करें।

    इंस्टॉल करें
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. प्रमाणीकरण

    Google Search अनुमति के साथ एक API कुंजी बनाएं, या एक अधिकृत कुंजी का पुन: उपयोग करें। इस टर्मिनल में इसे नीचे छिपे हुए प्रॉम्प्ट का उपयोग करके सेट करें।

    यदि FLASHDATA_API_KEY पहले से ही सेट किया गया है तो यह संकेत छोड़ दें। इन उदाहरणों में वेरिएबल को सीधे पढ़ा जाता है; वे .env फ़ाइलों को लोड नहीं करते हैं।

    छिपे हुए कुंजी संकेत 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_KEY
  3. खोज चलाएँ

    इसे quickstart.py के रूप में सहेजें, फिर इसे उसी आभासी वातावरण के साथ चलाएं। यह पांच परिणाम और प्रिंट शीर्षक, URLs और क्रेडिट के लिए एक Google Search अनुरोध बनाता है।

    quickstart.py
    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)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])
    चलाएँ
    .venv/bin/python quickstart.py
  4. परिणाम जाँचें

    सामान्य रूप से स्थिति की जांच के बाद स्क्रिप्ट बाहर निकलती है। स्रोत शीर्षक और URLs के बाद क्रेडिट्स का प्रयोग किया जाता है। एक खाली कार्बनिक सूची एक वैध प्रतिक्रिया है; परिणाम आपके क्वेरी के साथ भिन्न होते हैं।

    उदाहरण
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].organic[]
    Google Search हिट: शीर्षक, लिंक और स्निपेट। अन्य सूत्रों में अलग परिणाम क्षेत्र होते हैं।
    usage.credits
    इस अनुरोध की लागत। यहां तक कि पांच परिणाम एक खोज अनुरोध है।

एक और डेटा स्रोत आज़माएं

प्रत्येक टैब एक पूर्ण स्क्रिप्ट है। quickstart.py को एक उदाहरण के साथ बदलें और इसे कदम 3 से कमांड के साथ चलाएं। प्रत्येक रन एक नया अनुरोध प्रस्तुत करता है; कुंजी को दिखाया गया स्रोत अनुमति की आवश्यकता होती है।

google_news की आवश्यकता है। results[].news[] से लेख शीर्षक और स्रोत लिंक प्रिंट करता है।

quickstart.py
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.news("battery recycling", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for article in page.get("news", []):
            print(article.get("title"), article.get("link"))

क्या Python SDK समर्थन करता है

google / youtube
Google Search, समाचार, चित्र, खरीदारी, वीडियो और स्थान; YouTube खोज, मेटाडाटा, कैप्शन, ट्रांसक्रिप्ट और चैनल डेटा।
youtube.download
अपने क्लाउड स्टोरेज के लिए ऑडियो या वीडियो डिलीवरी का काम सबमिट करें। youtube_download अनुमति और भंडारण विन्यास की आवश्यकता है; नीचे पूर्ण डाउनलोड उदाहरण का पालन करें।
jobs / bulk
स्वीकृत नौकरी ID सेव करें, पूर्ण होने और परिणाम प्राप्त करने की प्रतीक्षा करें। बड़े वीडियो-ID डेटासेट के लिए थोक का उपयोग करें और एक पुनरारंभ के बाद मौजूदा नौकरियों को फिर से शुरू करें।
account
आवर्ती कार्य से पहले पहुंच, संतुलन, मूल्य निर्धारण, सीमा और उपयोग पढ़ें। अपने पर्यावरण या गुप्त स्टोर से अधिकृत कुंजी का पुन: उपयोग करें।
respond_with / accept
का प्रयोग करें respond_with="markdown" for Markdown in उत्तर ["content"], या स्वीकार = "text/plain" for a string. JSON शब्दकोश डिफ़ॉल्ट हैं।

Asyncio का उपयोग करें

इस संस्करण के साथ quickstart.py बदलें और उसी रन कमांड का उपयोग करें। AsyncFlashData एक ही संसाधन को इंतजार के साथ उजागर करता है। यह अभी भी एक वास्तविक समय खोज प्रतिक्रिया के लिए इंतजार करता है; mode="async" इसके बजाय सर्वर-साइड पृष्ठभूमि नौकरी जमा करता है।

Jupyter या एक चल घटना पाश के साथ एक आवेदन में, asyncio.run (मुख्य) के बजाय मुख्य () का इंतजार कर रहा है। उस घटना लूप के भीतर क्लाइंट का पुन: उपयोग करें।

quickstart.py
import asyncio
import os
from flashdata import AsyncFlashData

async def main():
    async with AsyncFlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = await client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])

asyncio.run(main())

अगला कदम

यदि कोई कदम विफल हो जाता है

ModuleNotFoundError
उसी अनुवादक के साथ स्थापित और चलाएं: .venv/bin/python -m pip शो फ्लैशडाटा (Windows: .\.venv\Scripts\python.exe -m pip show flashdata)। अपने स्क्रिप्ट flashdata.py नाम नहीं है।
KeyError: FLASHDATA_API_KEY / 401
उसी टर्मिनल में एक सक्रिय API कुंजी सेट करें। अकेले एक फ़ाइल इस उदाहरण से लोड नहीं है। एक API कुंजी का उपयोग करें, एक MCP OAuth टोकन नहीं।
403
इस कुंजी के लिए उदाहरण द्वारा आवश्यक स्रोत अनुमति देना।
402
उपलब्ध क्रेडिट के लिए Billing की जाँच करें। यदि परीक्षण का उपयोग समाप्त हो जाता है, तो अपने खाते की शेष राशि का उपयोग करने के लिए कनेक्शन का दावा करें।
429 / APIError
निरीक्षण error.retry_after और अनुरोध दर को कम करें। SDK प्रत्येक अनुरोध को एक बार भेजता है और स्वचालित रूप से पुनः प्राप्त नहीं करता है।
SubmissionUnknownError
एक समयबद्ध प्रस्तुतीकरण पहले से ही स्वीकार किया जा सकता है। इसे दोहराने से पहले History की जाँच करें; उपलब्ध होने पर एक बचाया नौकरी ID का पुनः उपयोग करें।
asyncio.run() / running event loop
एक नोटबुक या मौजूदा घटना लूप में मुख्य () का उपयोग करें। एक स्टैंडअलोन स्क्रिप्ट के लिए asyncio.run (मुख्य) रखें।
Markdown