Переглянути документацію
Початок роботи
Встановіть Python SDK і роздрукуйте результати пошуку з декількома лініями коду. Включає синхронні і асинхронні приклади.
Встановити SDK
Вимагає Python 3.10+. Запустіть ці команди в каталозі проекту. Уже використовуючи віртуальне середовище? Встановіть флешdata==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"Ауттентицид
Створіть ключ API з дозволом Google Search або повторно використовуйте уповноважений ключ. Встановіть його в цей термінал за допомогою прихованого підказка нижче.
Пропустити запит, якщо 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, після чого запустіть його з таким же віртуальним середовищем. Це робить запит 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Перевірте результат
Виходи скрипту зазвичай після перевірки стану. Заголовки джерела та URLs слідувати за використовуваними кредитами. Порожній органічний список є дією відповідь; результати змінюються з вашим запитом.
Приклад виходуBattery recycling research https://example.org/recycling Credits used: 0.02results[].organic[]- Google Search переглядів: назва, посилання та 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, Новини, Зображення, покупка, відео та місця; YouTube відкриття, метадані, підписи, перезаписи та дані каналів.
youtube.download- Надайте аудіо або відео доставку на хмарне сховище. Вимагає дозвіл youtube_download і налаштування зберігання; слідувати за повним прикладом завантаження нижче.
jobs / bulk- Заощаджуйте прийнятий роботу ID, чекайте завершення та отримання результатів. Використовуйте сипучих для збільшення відео-ID datasets і відновлюють існуючі робочі місця після перезавантаження.
account- Читання доступу, баланс, ціноутворення, ліміти та використання перед рецидивною роботою. Змініть уповноважений ключ від вашого середовища або секретного магазину.
respond_with / accept- Використовуйте respond_with="markdown" для Markdown у відповідь["content"], або приймати="text/plain" для рядка. JSON є типовими.
Використання асинхроніки
Замініть quickstart.py з цією версією і використовуйте команду запуску. AsyncFlashData виводить ті ж ресурси з очікуваним. Що ще чекає на відповідь на пошук в режимі реального часу; mode="async" подає серверну роботу замість роботи.
У Юпітері або аплікації з проточною петлею, використання чекає головний() замість 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 шоу флешки). Не ім'я вашого скрипта flashdata.py.
- KeyError: FLASHDATA_API_KEY / 401
- Встановіть активний ключ API в одному терміналі. Файл .env самостійно не завантажується цим прикладом. Використовуйте API ключ, не MCP OAuth токен.
- 403
- Надайте дозвіл на джерело, необхідний прикладом до цього ключа.
- 402
- Перевірте Billing для доступних кредитів. Якщо вичерпний доступ, застосуйте підключення до вашого облікового балансу.
- 429 / APIError
- Огляд error.retry_after і зменшення швидкості запиту. SDK надсилає кожен запит один раз і не змінює автоматично.
- SubmissionUnknownError
- Подання часу вже може бути прийнята. Перевірити History перед його повторенням; повторно використовувати збережену роботу ID при наявності.
- asyncio.run() / running event loop
- Використовуйте expect main() в блокнот або існуючій петлі заходу. Зареєструватися asyncio.run(голова()) для самостійного сценарію.