تصفح الوثائق
البدء
Install the Python SDK and printed search results with a few lines of code. تشمل أمثلة متزامنة وراسخة.
Install the SDK
Requires Python 3.10+. أدير هذه الأوامر في دليل مشروعك تستخدم بالفعل بيئة افتراضية؟ Install flashdata=1.1.0 with that environment's python -m pip instead.
تثبيت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"التوثيق
أنشئ مفتاح API بصلاحية Google Search أو أعد استخدام مفتاح مصرح له. اضبطه في هذه الطرفية عبر مطالبة الإدخال المخفي أدناه.
اقفز بسرعة إذا FLASHDATA_API_KEY تم تحديده بالفعل. وتقرأ هذه الأمثلة المتغير مباشرة؛ ولا تحمل ملفات " سين " .
مفتاح مخفي: 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ثم تشغيله مع نفس البيئة الافتراضية. وهو يقدم طلباً واحداً من طراز Google Search للحصول على ما يصل إلى خمسة من ألقاب النتائج والمطبوعات، و URLs، والائتمانات المستخدمة.
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تحقق من النتيجة
ينتهي السكربت طبيعيًا بعد التحقق من أن status هي done. توقّع عناوين المصادر وروابطها ثم الرصيد المستخدم. قائمة organic الفارغة استجابة صالحة؛ وتختلف النتائج حسب استعلامك.
الناتج المثاليBattery recycling research https://example.org/recycling Credits used: 0.02results[].organic[]- Google Search hits: title, link and snippet. وهناك مصادر أخرى لها مجالات مختلفة للنتائج.
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 وNews وImages وShopping وVideos وPlaces؛ واكتشاف فيديوهات YouTube والبيانات الوصفية والترجمات النصية والنصوص المفرغة وبيانات القنوات.
youtube.download- قم بتوصيل وظيفة تسجيل صوتي أو فيديو لتخزينك السحابي (ب) اشتراطات الأذن والتخزين من طراز youtube_download؛ واتباع نموذج التحميل الكامل الوارد أدناه.
jobs / bulk- وفّر الوظيفة المقبولة ID، وانتظر إنجازها واسترجاع نتائجها. استخدام السوائب في مجموعات بيانات أكبر من طراز ID واستئناف الوظائف القائمة بعد إعادة التشغيل.
account- اقرأوا الولوج، والتوازن، والتسعير، والحدود، والاستخدام قبل العمل المتكرر. إعادة استخدام المفتاح المأذون به من بيئتك أو متجرك السري.
respond_with / accept- Use respond_with="markdown" for Markdown in response["content"], or accept="text/plain" for a string. JSON القاموس هو الفشل
Use asyncio
يستعاض عن quickstart.py بهذه النسخة واستخدام نفس القيادة. وتكشف شركة AsyncFlashData نفس الموارد التي تنتظرها. ولا يزال ذلك ينتظر استجابة بحثية في الوقت الحقيقي؛ وتقدم شركة mode="async" بدلا من ذلك وظيفة خلفية في جانب الخادم.
In Jupyter or an application with a running event cycle, use await main whoa rather of asyncio.run(main). إعادة استخدام العميل في حلقة الحدث تلك
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 - م pip برنامج " فليلداتا " ()Windows: / venv/Scripts /python.exe - م pip برنامج "البيانات" لا تُسمّي نصّكَ 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لكتابة نص مستقل