تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

البدء

Python SDK

Install the Python SDK and printed search results with a few lines of code. تشمل أمثلة متزامنة وراسخة.

  1. 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"
  2. التوثيق

    أنشئ مفتاح 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
  3. نفّذ بحثًا

    احفظ هذا quickstart.pyثم تشغيله مع نفس البيئة الافتراضية. وهو يقدم طلباً واحداً من طراز Google Search للحصول على ما يصل إلى خمسة من ألقاب النتائج والمطبوعات، و URLs، والائتمانات المستخدمة.

    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. تحقق من النتيجة

    ينتهي السكربت طبيعيًا بعد التحقق من أن status هي done. توقّع عناوين المصادر وروابطها ثم الرصيد المستخدم. قائمة organic الفارغة استجابة صالحة؛ وتختلف النتائج حسب استعلامك.

    الناتج المثالي
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].organic[]
    Google Search hits: title, link and snippet. وهناك مصادر أخرى لها مجالات مختلفة للنتائج.
    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 و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). إعادة استخدام العميل في حلقة الحدث تلك

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 - م 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لكتابة نص مستقل