Przeglądaj dokumentację
Pierwsze kroki
Zainstaluj Python SDK i wydrukuj wyniki wyszukiwania za pomocą kilku linii kodu. Obejmuje przykłady synchroniczne i asyncio.
Zainstaluj SDK
Wymaga Python 3.10 +. Uruchom te polecenia w katalogu projektu. Już używasz wirtualnego środowiska? Zainstaluj flashdata = = 1.1.0 z tym pytonem środowiska -m pip zamiast.
Zainstalujpython3 -m venv .venv .venv/bin/python -m pip install "flashdata==1.1.0"Zainstalujpy -3 -m venv .venv .\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"Uwierzytelnij
Utwórz klucz API za zgodą Google Search lub ponownie użyj autoryzowanego klucza. Ustaw go w tym terminalu za pomocą ukrytego sygnału poniżej.
Pomiń polecenie, jeśli FLASHDATA_API_KEY jest już ustawiony. Przykłady te odczytują bezpośrednio zmienną; nie ładują plików .env.
Ukryty sygnał klawiszowy · 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_KEYUkryty sygnał klawiszowy · 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 flashdataSecureKeyWykonaj wyszukiwanie
Zapisz to jako quickstart.py, a następnie uruchom to z tym samym wirtualnym środowiskiem. Zrobi jeden wniosek Google Search dla maksymalnie pięciu wyników i wydruków tytułów, URLs i kredytów używanych.
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"])Uruchom.venv/bin/python quickstart.pyUruchom.\.venv\Scripts\python.exe quickstart.pySprawdź wynik
Skrypt wychodzi normalnie po sprawdzeniu stanu jest gotowy. Oczekuj tytułów źródłowych i URLs, a następnie kredytów używanych. Pusta lista organicznych jest poprawną odpowiedzią; wyniki różnią się w zależności od zapytania.
Przykład wyjściaBattery recycling research https://example.org/recycling Credits used: 0.02results[].organic[]- Google Search hits: title, link and snippet. Inne źródła mają różne pola wyników.
usage.credits- Koszt tej prośby. Do pięciu wyników tutaj są jeden wniosek o wyszukiwanie.
Spróbuj innego źródła danych
Każda zakładka jest kompletnym skryptem. Zastąp quickstart.py jednym przykładem i uruchom go poleceniem z kroku 3. Każda runda składa jeden nowy wniosek; klucz wymaga pokazanego pozwolenia źródłowego.
Wymaga google_news. Drukuje tytuły artykułów i linki źródłowe z 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"))Wymaga youtube_metadata. Drukuje tytuł wideo, kanał i czas trwania w sekundach. Zastąp wideo ID jednym, który chcesz sprawdzić.
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"))Wymaga youtube_transcript. Drukuje istniejący angielski automatyczny transkrypt z results[].fullText. Wideo musi mieć ten utwór; to wywołanie nie generuje ani nie przetłumacza napisów.
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", ""))Co obsługuje Python SDK
google / youtube- Google Search, Aktualności, Zdjęcia, Zakupy, Filmy i Miejsca; Odkrycie YouTube, metadane, podpisy, transkrypcje i dane kanałowe.
youtube.download- Prześlij zadanie dostarczania dźwięku lub obrazu do pamięci masowej w chmurze. Wymaga uprawnień youtube_download i konfiguracji pamięci masowej; postępuj zgodnie z poniższym przykładem pobierania.
jobs / bulk- Zapisz przyjęte zadanie ID, czekaj na ukończenie i pobrać wyniki. Użyj luzem dla większych zbiorów danych wideo ID i wznowić istniejące zadania po ponownym uruchomieniu.
account- Odczyt dostępu, równowagi, cen, ograniczeń i wykorzystania przed powtarzającą się pracą. Ponownie użyj autoryzowanego klucza ze swojego środowiska lub tajnego sklepu.
respond_with / accept- Użyj respond_with = "markdown" dla Markdown w odpowiedzi ["content"] lub zaakceptuj = "text/plain" dla łańcucha. Słowniki JSON są domyślne.
Należy stosować asyncio
Zastąp quickstart.py tą wersją i użyj tej samej komendy. AsyncFlashData eksponuje te same zasoby oczekując. To nadal czeka na odpowiedź wyszukiwania w czasie rzeczywistym; mode="async" zamiast tego przedstawia zadanie w tle po stronie serwera.
W programie lub aplikacji z uruchomioną pętlą zdarzeń, zamiast asyncio.run (main () należy czekać na główny (). Ponownie użyj klienta w tej pętli zdarzeń.
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())Kolejne kroki
Jeśli krok zawiedzie
- ModuleNotFoundError
- Zainstaluj i uruchom z tym samym tłumaczem: .venv/bin/python -m pip wyświetla flashdata (Windows:.\ .venv\ Scripts\ python.exe -m pip pokazuje flashdata). Nie nazywaj skryptu flashdata.py.
- KeyError: FLASHDATA_API_KEY / 401
- Ustaw aktywny klucz API w tym samym terminalu. Sam plik .env nie jest wczytany przez ten przykład. Użyj klawisza API, a nie symbolu MCP OAuth.
- 403
- Udziel pozwolenia na korzystanie ze źródła wymaganego przez przykład tego klucza.
- 402
- Sprawdź Billing dostępne kredyty. Jeśli dostęp do procesu jest wyczerpany, należy zażądać połączenia, aby skorzystać z Twojego konta.
- 429 / APIError
- Sprawdź error.retry_after i zmniejszyć stopę zapotrzebowania. SDK wysyła każde żądanie raz i nie próbuje ponownie automatycznie.
- SubmissionUnknownError
- Złożenie wniosku o wydanie orzeczenia może być już przyjęte. Zaznacz History przed powtórzeniem go; ponownie użyj zapisanego zadania ID, jeśli jest dostępny.
- asyncio.run() / running event loop
- Użyj czekać na główny () w notebooku lub istniejącej pętli zdarzeń. Zachowaj asyncio.run (main ()) dla skryptu samodzielnego.