Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Pierwsze kroki

Python SDK szybki start

Zainstaluj Python SDK i wydrukuj wyniki wyszukiwania za pomocą kilku linii kodu. Obejmuje przykłady synchroniczne i asyncio.

  1. 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.

    Zainstaluj
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. 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_KEY
  3. Wykonaj 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.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"])
    Uruchom
    .venv/bin/python quickstart.py
  4. Sprawdź 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ścia
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].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[].

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

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ń.

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

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.