Belgeleri incele
Başlarken
Python SDK'u yükleyin ve birkaç kodla arama sonuçlarını yazdırın. senkronize ve asyncio örneklerini içerir.
Yüklemek için SDK
Python 3.10+'yı gerektirir. Bu komutları proje rehberinizde çalıştırın. Zaten bir sanal ortam kullanıyor mu? Flashdata==1.1.0'u bu çevrenin python ile yükleyin - yerine pip.
Yüklepython3 -m venv .venv .venv/bin/python -m pip install "flashdata==1.1.0"Yüklepy -3 -m venv .venv .\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"Kimlik Doğrulama
API anahtarını Google Search izni ile oluşturun veya yetkili bir anahtarı yeniden kullanın. Bu terminalde aşağıda gizli bir şekilde ayarlayın.
FLASHDATA_API_KEY'un zaten ayarlandığı gibi hızlı bir şekilde girin. Bu örnekler değişkeni doğrudan okur; .env dosyaları yüklemezler.
Gizli anahtar · 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_KEYGizli anahtar · 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 flashdataSecureKeyArama çalıştırın
Bunu quickstart.py olarak kurtar, sonra aynı sanal ortamda çalıştırın. Bu, beş sonuca kadar Google Search isteği yapar ve listeler, URLs ve kullanılan krediler yapar.
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"])Çalıştır.venv/bin/python quickstart.pyÇalıştır.\.venv\Scripts\python.exe quickstart.pySonucu kontrol edin
Senaryo normalde durumu kontrol ettikten sonra çıkıyor. Kaynak başlıkları ve URLs, kullanılan Krediler tarafından takip edildi. Boş organik bir liste geçerli bir yanıttır; sonuçlar sorgunuzla değişir.
Örnek çıktıBattery recycling research https://example.org/recycling Credits used: 0.02results[].organic[]- Google Search hit: başlık, bağlantı ve parçalar. Diğer kaynaklar farklı sonuç alanları vardır.
usage.credits- Bu talebin maliyeti. Buradaki beş sonuça kadar bir arama isteği.
Başka bir veri kaynağı deneyin
Her sekme tam bir senaryodur. quickstart.py'u bir örnekle değiştirin ve 3 adımdan kumanda ile çalıştırın. Her işletme yeni bir istek sunar; anahtarın gösterilen kaynak iznine ihtiyacı vardır.
google_news izni gerekir. results[].news[] içindeki haber başlıklarını ve kaynak bağlantılarını yazdırır.
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'u gerektirir. Video unvanı, kanal ve saniyeler içinde. Video ID'u denetim etmek istediğiniz biri ile değiştirin.
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'u gerektirir. results[].fullText.'dan mevcut bir İngilizce otomatik transkript Videonun bu yolda olması gerekir; bu çağrı oluşturmaz veya komutlar çevirmez.
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 ne destekliyor
google / youtube- Google Search, Haberler, Görüntüler, Alışveriş, Videolar ve Yerler; YouTube keşif, metadata, altyazılar, transkriptler ve kanal verileri.
youtube.download- Bulut depolamanıza bir ses veya video teslimat işi gönderin. youtube_download izin ve depolama yapılandırması gerektirir; aşağıdaki tam indirme örneği izleyin.
jobs / bulk- Kabul edilen işi kurtarmak ID, tamamlanmak ve sonuçları almak için bekleyin. Daha büyük video-ID veri setleri için büyük miktarda kullanın ve bir yeniden başlatmadan sonra mevcut işlere devam edin.
account- Erişim, denge, fiyatlandırma, limitler ve kullanım tekrarlanan çalışmadan önce. Çevrenizden veya gizli mağazanızdan yetkili bir anahtar kullanın.
respond_with / accept- respond_with="markdown" için Markdown'u yanıt olarak kullanın ("content") veya bir dize için kabul ="text/plain"'u kabul edin. JSON sözlükleri varsayılandir.
Asyncio kullanın
quickstart.py'u bu sürümle değiştirin ve aynı koşu komutunu kullanın. AsyncFlashData, aynı kaynakları bekleyerek ortaya koyar. Bu hala gerçek zamanlı bir arama yanıtını bekler; mode="async" bunun yerine bir sunucu arka plan işi gönderir.
Jupyter veya çalışan bir olay döngüsü ile bir uygulama, asyncio.run(main() yerine ana() kullanın. Müşteriyi bu olay döngüsü içinde yeniden kullanın.
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())Sonraki adımlar
Bir adım başarısız olursa
- ModuleNotFoundError
- Aynı tercümanla yükleme ve koşma: .venv/bin/python -m pip show flashdata (Windows: .\.venv\Scripts\python.exe -m pip show flashdata). Senaryo flashdata.py adını kullanmayın.
- KeyError: FLASHDATA_API_KEY / 401
- Aynı terminalde aktif bir API anahtarı ayarlayın. Tek başına bir .env dosyası bu örnek tarafından yüklenemez. Bir API anahtarı kullanın, bir MCP OAuth token değil.
- 403
- Örneğin bu anahtara gerekli olan kaynak iznini verin.
- 402
- Billing'u mevcut krediler için kontrol edin. Eğer deneme erişimi tükenmişse, hesabınızı bakiyenizi kullanmak için bağlantıyı iddia edin.
- 429 / APIError
- Inspect error.retry_after ve istek oranını azaltır. SDK her isteği bir kez gönderir ve otomatik olarak yeniden denemez.
- SubmissionUnknownError
- Bir zaman teslimi zaten kabul edilebilir. History'u tekrarlamadan önce kontrol edin; mevcut olduğunda kaydedilen ID'u yeniden kullanın.
- asyncio.run() / running event loop
- Bir not defteri veya mevcut olay döngüsünde ana()'ı bekleyin. asyncio.run(main()) bir standalone senaryosu için tutun.