İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Başlarken

Python SDK hızlı başlangıç

Python SDK'u yükleyin ve birkaç kodla arama sonuçlarını yazdırın. senkronize ve asyncio örneklerini içerir.

  1. 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ükle
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. 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_KEY
  3. Arama ç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.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"])
    Çalıştır
    .venv/bin/python quickstart.py
  4. Sonucu 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.02
    results[].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.

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

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.

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

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.