दस्तावेज़ देखें
शुरू करें
Python SDK स्थापित करें और कुछ लाइनों के कोड के साथ खोज परिणाम प्रिंट करें। तुल्यकालिक और asyncio उदाहरण शामिल हैं।
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"इंस्टॉल करेंpy -3 -m venv .venv .\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"प्रमाणीकरण
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छिपे हुए कुंजी संकेत PowerShell# 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खोज चलाएँ
इसे quickstart.py के रूप में सहेजें, फिर इसे उसी आभासी वातावरण के साथ चलाएं। यह पांच परिणाम और प्रिंट शीर्षक, URLs और क्रेडिट के लिए एक Google Search अनुरोध बनाता है।
quickstart.pyimport 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चलाएँ.\.venv\Scripts\python.exe quickstart.pyपरिणाम जाँचें
सामान्य रूप से स्थिति की जांच के बाद स्क्रिप्ट बाहर निकलती है। स्रोत शीर्षक और URLs के बाद क्रेडिट्स का प्रयोग किया जाता है। एक खाली कार्बनिक सूची एक वैध प्रतिक्रिया है; परिणाम आपके क्वेरी के साथ भिन्न होते हैं।
उदाहरणBattery recycling research https://example.org/recycling Credits used: 0.02results[].organic[]- Google Search हिट: शीर्षक, लिंक और स्निपेट। अन्य सूत्रों में अलग परिणाम क्षेत्र होते हैं।
usage.credits- इस अनुरोध की लागत। यहां तक कि पांच परिणाम एक खोज अनुरोध है।
एक और डेटा स्रोत आज़माएं
प्रत्येक टैब एक पूर्ण स्क्रिप्ट है। quickstart.py को एक उदाहरण के साथ बदलें और इसे कदम 3 से कमांड के साथ चलाएं। प्रत्येक रन एक नया अनुरोध प्रस्तुत करता है; कुंजी को दिखाया गया स्रोत अनुमति की आवश्यकता होती है।
google_news की आवश्यकता है। results[].news[] से लेख शीर्षक और स्रोत लिंक प्रिंट करता है।
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"))youtube_metadata की आवश्यकता है। वीडियो शीर्षक, चैनल और अवधि को सेकंड में प्रिंट करता है। जिस वीडियो में आप निरीक्षण करना चाहते हैं उसके साथ वीडियो ID को बदलें।
import os
from flashdata import FlashData
with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
response = client.youtube.metadata("dQw4w9WgXcQ", include_formats=False)
if response["status"] != "done":
raise RuntimeError(response)
for video in response["results"]:
print(video.get("title"), video.get("channel"))
print("Seconds:", video.get("duration"))youtube_transcript की आवश्यकता है। results[].fullText. से एक मौजूदा अंग्रेजी स्वचालित ट्रांसक्रिप्ट प्रिंट करता है वीडियो में वह ट्रैक होना चाहिए; यह कॉल कैप्शन उत्पन्न या अनुवाद नहीं करता है।
import os
from flashdata import FlashData
with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
response = client.youtube.transcript("dQw4w9WgXcQ", language="en", auto=True)
if response["status"] != "done":
raise RuntimeError(response)
for track in response["results"]:
print(track.get("fullText", ""))क्या 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 (मुख्य) के बजाय मुख्य () का इंतजार कर रहा है। उस घटना लूप के भीतर क्लाइंट का पुन: उपयोग करें।
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 (मुख्य) रखें।