# Python SDK

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

مرجع كانوني: https://flashdata.dev/ar/docs/guides/flashdata-python
Reviewed: 2026-11-04 by FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-python) — المصدر SDK المرجع المرجعي
- [احصل على مفتاح API](https://flashdata.dev/app/api-keys) — إنشاء مفتاح في الضمادات

<a id="application"></a>

## إجعلْك أولاً Python الطلب

اثبتوا SDKجهزوا API مفتاح وبحث واحد الردود هي القاموس من طراز Python حسب التقصير.

- [Python SDK](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)
- [PyPI](https://pypi.org/project/flashdata/1.1.0/)

<a id="install"></a>

### Install the SDK

Requires Python 3.10+. أدير هذه الأوامر في دليل مشروعك تستخدم بالفعل بيئة افتراضية؟ Install flashdata=1.1.0 with that environment's python -m pip instead.

#### Linux / macOS

##### تثبيت

```bash
python3 -m venv .venv
.venv/bin/python -m pip install "flashdata==1.1.0"
```


#### Windows PowerShell

##### تثبيت

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"
```


- [Install Python](https://www.python.org/downloads/)

<a id="key"></a>

### التوثيق

أنشئ مفتاح API بصلاحية Google Search أو أعد استخدام مفتاح مصرح له. اضبطه في هذه الطرفية عبر مطالبة الإدخال المخفي أدناه.

اقفز بسرعة إذا FLASHDATA_API_KEY تم تحديده بالفعل. وتقرأ هذه الأمثلة المتغير مباشرة؛ ولا تحمل ملفات " سين " .

#### Bash

##### مفتاح مخفي: Bash

```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 7

##### مفتاح مخفي: PowerShell

```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
```


- [التسجيل](https://flashdata.dev/signup)
- [فتح API Keys](https://flashdata.dev/app/api-keys)
- [Open Billing](https://flashdata.dev/app/billing)
- [تجربة العميل](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md)

<a id="query"></a>

### نفّذ بحثًا

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

#### quickstart.py

```python
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"])
```

#### Linux / macOS

##### تشغيل

```bash
.venv/bin/python quickstart.py
```


#### Windows PowerShell

##### تشغيل

```powershell
.\.venv\Scripts\python.exe quickstart.py
```



<a id="result"></a>

### تحقق من النتيجة

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

| الميدان | الاستخدام |
| --- | --- |
| results[].organic[] | Google Search hits: title, link and snippet. وهناك مصادر أخرى لها مجالات مختلفة للنتائج. |
| usage.credits | تكلفة هذا الطلب. ما يصل إلى خمسة نتائج هنا طلب بحث واحد. |

#### الناتج المثالي

```text
Battery recycling research https://example.org/recycling
Credits used: 0.02
```


<a id="common-tasks"></a>

## جرب مصدر بيانات آخر

كل كتاب هو نص كامل. يستعاض عن quickstart.py بمثال واحد ويديره بالقيادة من الخطوة 3. وتقدم كل عملية طلباً جديداً واحداً؛ ويحتاج المفتاح إلى إذن المصدر المبيَّن.

### Google News

يتطلب google_news. يطبع عناوين المقالات وروابط مصادرها من results[].news[].

#### quickstart.py

```python
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

الاحتياجات youtube_metadata. يطبع عنوان الفيديو، القناة والمدة في ثواني. إستبدل الفيديو ID مع واحد تريد أن تفتش.

#### quickstart.py

```python
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

الاحتياجات youtube_transcript. طبع نص آلي الإنجليزية الحالي من results[].fullText. ويجب أن يكون للفيديو هذا المسار؛ ولا تولد هذه الدعوة أو تترجم الاختباءات.

#### quickstart.py

```python
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", ""))
```


- [جميع أساليب ومعايير المصادر](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/sources/index.md)

<a id="features"></a>

## ما يدعمه Python SDK

| الاستخدام | نقاط الدخول 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 القاموس هو الفشل |

- [تحميل كامل Python على سبيل المثال](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [تخزين حمولة المصادرة](https://flashdata.dev/ar/docs/guides/youtube-download-guide/reference.md)
- [صيغ الاستجابة Python](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/response-formats.md)

<a id="asyncio"></a>

## 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

```python
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())
```

- [Async](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/client.md)

<a id="next"></a>

## الخطوات التالية

- [التحقق من الحسابات وتحقيق النتائج](https://flashdata.dev/ar/docs/guides/sdk-operations/reference.md)
- [الوظائف الأساسية والخبز](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/jobs.md)
- [بيانات Bulk](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/bulk.md)
- [SDK](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)

<a id="errors"></a>

## إذا فشلت خطوة

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

- [التاريخ](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Python الأخطاء والانتعاش](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/errors.md)
