# Python SDK khởi chạy nhanh

Cài đặt Python SDK và in kết quả tìm kiếm với vài dòng mã. Bao gồm cả những ví dụ đồng bộ và đặc trưng.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/flashdata-python
Xem lại: 2026-11-04 by FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-python) — Nguồn và tham khảo SDK
- [Lấy khóa API](https://flashdata.dev/app/api-keys) — Tạo một phím trong bàn điều khiển

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

## Tạo yêu cầu Python đầu tiên

Cài SDK, thiết lập khóa API và chạy một lượt tìm kiếm. Theo mặc định, phản hồi là dictionary của Python.

- [Python SDK tham chiếu](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>

### Cài đặt SDK

Yêu cầu Python 3.10+. Chạy những lệnh này trong thư mục dự án của bạn. Đã sử dụng môi trường ảo chưa? Cài đặt==1.1.0 với môi trường python -m pip Thay vào đó.

#### Linux / macOS

##### Cài đặt

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


#### Windows PowerShell

##### Cài đặt

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


- [Cài đặt Python](https://www.python.org/downloads/)

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

### Xác thực

Tạo ra một API phím với Google Search cho phép, hoặc sử dụng lại một phím được ủy quyền. Đặt nó trong thiết bị cuối này bằng dấu nhắc ẩn bên dưới.

Bỏ qua dấu nhắc nếu FLASHDATA_API_KEY đã được thiết lập. Những ví dụ này đọc trực tiếp biến; chúng không tải tập tin .env.

#### Bash

##### Phím ẩn nhắc điều · 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

##### Phím ẩn nhắc điều · 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
```


- [Đăng ký](https://flashdata.dev/signup)
- [Mở API Keys](https://flashdata.dev/app/api-keys)
- [Mở Billing](https://flashdata.dev/app/billing)
- [Thiết lập tác nhân phiên tòa](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md)

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

### Chạy tìm kiếm

Lưu vào quickstart.py, sau đó chạy cùng một môi trường ảo. Nó làm ra một cái Google Search Yêu cầu cho đến năm kết quả và in tiêu đề, URLs và dùng tín dụng.

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

##### Chạy

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


#### Windows PowerShell

##### Chạy

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



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

### Kiểm tra kết quả

Thông thường, khi kiểm tra xong trạng thái, tập lệnh sẽ được thoát. Mong đợi tên nguồn và URLs Sau đó là các nguồn tư liệu được sử dụng. Một danh sách hữu cơ rỗng là một câu trả lời hợp lệ; kết quả khác nhau với yêu cầu của bạn.

| Tìm kiếm | Dùng |
| --- | --- |
| results[].organic[] | Google Search truy cập: tiêu đề, liên kết và trích. Những nguồn khác thì có những trường kết quả khác nhau. |
| usage.credits | Chi phí cho yêu cầu này. Kết quả là một yêu cầu tìm kiếm. |

#### Đầu ra Ví dụ

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


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

## Thử một nguồn dữ liệu khác

Mỗi thẻ là một văn lệnh đầy đủ. Thay thế quickstart.py với một ví dụ và chạy nó với lệnh từ bước 3. Mỗi lần chạy đệ trình một yêu cầu mới; chìa khóa cần sự cho phép nguồn.

### Tin tức Google

Yêu cầu google_news. In tựa bài và liên kết nguồn từ 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 Siêu dữ liệu

Yêu cầu youtube_metadata. In tiêu đề phim, kênh và khoảng thời gian trong vài giây. Thay thế đoạn phim ID với một cái mà anh muốn kiểm tra.

#### 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"))
```


### Bản ghi YouTube

Yêu cầu youtube_transcript. In một bản ghi tiếng Anh đã có từ results[].fullText. Video phải có theo dõi đó; cuộc gọi này không tạo ra hoặc dịch phụ đề.

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


- [Mọi phương pháp và tham số nguồn](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/sources/index.md)

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

## Cái quái gì... Python SDK Hỗ trợ

| Dùng | SDK điểm nhập |
| --- | --- |
| google / youtube | Google SearchTin tức, hình ảnh, mua sắm, videos và Places; YouTube Khám phá, siêu dữ liệu, chú thích, ghi chép và dữ liệu kênh. |
| youtube.download | Gửi một công việc chuyển phát âm thanh hay video đến kho lưu trữ đám mây của bạn. Yêu cầu youtube_download cho phép và cấu hình lưu trữ; theo sau toàn bộ việc tải về ví dụ bên dưới. |
| jobs / bulk | Lưu công việc đã nhận IDChờ kết quả hoàn thành và lấy lại kết quả. Dùng số lượng lớn cho bộ dữ liệu video-ID lớn hơn và tiếp tục công việc đã có sau khi khởi động lại. |
| account | Đọc sách, giữ thăng bằng, giá cả, giới hạn và sử dụng trước khi làm việc lặp lại. Dùng lại chìa khóa được ủy quyền từ môi trường hay cửa hàng bí mật. |
| respond_with / accept | Dùng respond_with="markdown" Vì Markdown để đáp ứng["content"], hoặc chấp nhận ="text/plain" cho một sợi dây. JSON Từ điển là một điều mặc định. |

- [Hoàn tất Python tải về ví dụ](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [Cấu hình kho lưu tải về](https://flashdata.dev/vi/docs/guides/youtube-download-guide/reference.md)
- [Python Định dạng trả lời](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/response-formats.md)

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

## Sử dụng một định kỳ

Thay thế quickstart.py bằng phiên bản này và sử dụng cùng một lệnh chạy. Một một điểm sốc đã phơi bày cùng những vật dụng để đợi. Điều này vẫn chờ đợi một đáp ứng tìm kiếm thời gian thực; mode="async" Thay vào đó, gửi một tác vụ nền của máy phục vụ.

Trong vòng lặp sự kiện đang chạy, hãy dùng tùy chọn này thay vào đó là đợi phím chính () asyncio.run(main) Hãy tái sử dụng khách hàng trong vòng lặp sự kiện đó.

### 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 cấu hình trạm khách](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/client.md)

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

## Bước kế

- [Kiểm tra tài khoản và lưu kết quả](https://flashdata.dev/vi/docs/guides/sdk-operations/reference.md)
- [Nền và mẻ](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/jobs.md)
- [Bulk Bộ dữ liệu](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/bulk.md)
- [SDK tham chiếu phương thức](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)

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

## Nếu một bước không thành công

| Vấn đề | Sửa |
| --- | --- |
| ModuleNotFoundError | Cài đặt và chạy với cùng một bộ giải thích: .venv/bin/python -m pip hiển thị đèn flashdata (Windows: .\.venv\Scripts\python.exe -m pip hiển thị flashdata). Đừng đặt tên cho văn lệnh của bạn flashdata.py. |
| KeyError: FLASHDATA_API_KEY / 401 | Đặt hoạt động API Chìa khóa trong cùng một thiết bị cuối. Ví dụ này không thể tải chỉ một tập tin .env. Dùng a API không phải là... MCP OAuth làm ơn đi. |
| 403 | Hãy ban cho quyền truy cập nguồn cần thiết qua ví dụ về chìa khóa này. |
| 402 | Kiểm tra Billing cho các tín dụng có sẵn. Nếu quyền truy cập thử nghiệm bị cạn kiệt, hãy yêu cầu bạn dùng số tiền số dư tài khoản của bạn. |
| 429 / APIError | Kiểm tra error.retry_after và giảm mức yêu cầu. Hạt SDK gửi mỗi yêu cầu một lần và không thử lại tự động. |
| SubmissionUnknownError | Có thể đã chấp nhận một sự phục tùng hết hạn. Kiểm tra History trước khi lặp lại; dùng lại một công việc đã lưu ID khi nào rảnh. |
| asyncio.run() / running event loop | Dùng đợi phím chính () trong sổ ghi chú hay vòng lặp sự kiện đã có. Giữ asyncio.run(mai) cho một văn lệnh đứng vững. |

- [Yêu cầu lịch sử](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Python lỗi và phục hồi](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/errors.md)
