Semak dokumentasi
Mula di sini
Anstal Python SDK dan cetak hasil pencarian dengan beberapa baris kode. Ada juga contoh sinkronis dan asyncio.
Pasang SDK
Kemudi membutuhkan Python 3.10+. Jalankan perintah ini dalam direktori projek anda. Sudah menggunakan lingkungan virtual? Anstal flashdata==1.1.0 dengan python lingkungan itu -m pip sebagai gantinya.
Pasangpython3 -m venv .venv .venv/bin/python -m pip install "flashdata==1.1.0"Pasangpy -3 -m venv .venv .\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"Autentifikasi
Aathenthez Membuat kunci API dengan izin Google Search, atau menggunakan kembali kunci yang berwenang. Diset dalam terminal ini menggunakan tanda di bawah.
Skip ke prompt jika FLASHDATA_API_KEY sudah ditetapkan. Contoh-contoh ini beberapa contoh membaca variabel secara langsung; mereka tidak memuat berkas .env.
Prompt kunci tersembunyi · 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_KEYPrompt kunci tersembunyi · 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 flashdataSecureKeyJalankan carian
Simpan ini sebagai quickstart.py, kemudian jalankan dengan lingkungan virtual yang sama. Ia membuat satu permintaan Google SearchQ untuk hingga lima hasil dan mencetak gelar, URLs dan kredit yang digunakan.
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"])Jalankan.venv/bin/python quickstart.pyJalankan.\.venv\Scripts\python.exe quickstart.pySemak hasil
script keluar normal setelah pemeriksaan status dilakukan. Gelar sumber dan URLs diikuti oleh Credits digunakan. Daftar organik kosong adalah tanggapan yang sah; hasil bervariasi dengan pertanyaan Anda.
Contoh outputBattery recycling research https://example.org/recycling Credits used: 0.02results[].organic[]- Mohamad Google Search hits: title, link dan snippet. Sumber-sumber lain memiliki bidang hasil yang berbeda-beda.
usage.credits- Biaya permintaan ini. Sampai lima hasil di sini adalah satu permintaan pencarian.
Coba sumber data lain
Setiap tab adalah naskah lengkap. Megantikan quickstart.py dengan satu contoh dan jalankan dengan perintah dari langkah 3. Setiap run menyerahkan satu permintaan baru; kunci membutuhkan izin sumber yang ditunjukkan.
Perlu google_news. Artikel dan link sumber dari 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"))Perlu youtube_metadata. Untuk mencetak judul video, saluran dan durasi dalam detik. Merebut kembali video ID dengan satu yang ingin anda periksa.
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"))Perlu youtube_transcript. Kodator Cetak transkrip otomatis Inggris yang sudah ada dari results[].fullText. Video itu pasti memiliki trek itu; panggilan ini tidak menghasilkan atau menerjemahkan kapsi.
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", ""))Apa yang didukung Python SDK
google / youtube- Google Search, Berita, Gambar, Belanja, Video dan Tempat; Penemuan YouTube, metadata, kapsi, transkrip dan data saluran.
youtube.download- Kirimkan pekerjaan pengiriman audio atau video ke penyimpanan awan Anda. Ketergantungan memerlukan izin youtube_download dan konfigurasi penyimpanan; ikuti contoh unduhan lengkap di bawah ini.
jobs / bulk- Simpan pekerjaan yang diterima ID, tunggu penyelesaian dan hasil pengambilan. Mesin pukal digunakan untuk dataset video-ID yang lebih besar dan melanjutkan kembali pekerjaan yang sudah ada setelah restart.
account- KISAH, keseimbangan, harga, batas, dan penggunaan yang mudah dibaca sebelum pekerjaan yang berulang. Anda menggunakan kembali kunci yang sah dari lingkungan atau toko rahasia Anda.
respond_with / accept- Gunakan respond_with="markdown" untuk Markdown sebagai respon["content"], atau terima="text/plain" untuk sebuah string. Kamus JSON adalah standar.
Zudha menggunakan asyncio
Megantikan quickstart.py dengan versi ini dan menggunakan perintah lari yang sama. AndikasyncFlashData mengekspos sumber daya yang sama dengan menunggu. Ini masih menunggu respon pencarian realtime; mode="async" menyerahkan pekerjaan latar belakang sisi-server sebagai gantinya.
Di Jupyter atau aplikasi dengan loop event yang berjalan, gunakan tunggu main() alih-alih asyncio.run(main)). Gunakan kembali klien dalam lingkaran peristiwa itu.
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())Langkah - langkah selanjutnya
Jika langkah gagal
- ModuleNotFoundError
- Pasang dan jalankan dengan penterjemah yang sama: .venv/bin/python -m pip show flashdata (Windows: .\.venv\Scripts\python.exe -m pip show flashdata). Jangan namakan skrip anda flashdata.py.
- KeyError: FLASHDATA_API_KEY / 401
- API aktif di terminal yang sama. Sebuah berkas .env saja tidak dimuat oleh contoh ini. Use an API Kunci, bukan kunci MCP OAuth token.
- 403
- Berikan izin sumber yang diperlukan oleh contoh kunci ini.
- 402
- Periksa Billing untuk kredit yang tersedia. Jika akses pengadilan telah habis, klaim koneksi untuk menggunakan saldo rekening Anda.
- 429 / APIError
- Periksa error.retry_after dan kurangi nilai permintaan. SDK mengirim setiap permintaan sekali dan tidak mencoba lagi secara otomatis.
- SubmissionUnknownError
- Pengiriman timed-out mungkin sudah diterima. Periksa History sebelum mengulanginya; gunakan kembali pekerjaan tersimpan ID bila tersedia.
- asyncio.run() / running event loop
- Use wait main() dalam notebook atau loop event yang ada. Keep asyncio.run(main()) untuk skrip standalone.