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

Başlarken

SDK ile hesap kontrolleri ve kaydedilmiş sonuçlar

Kontrol maliyeti, her girişimden bir rekor tut ve başka bir API çağrı olmadan kaydedilen sonuçları okuyun.

Bu sayfada

Başlamadan önce başlamadan önce

Projeyi kullanın, SDK ve FLASHDATA_API_KEY'u SDK'dan kurdunuz. Aşağıda bir dil seçin. Her yeni run rehberi, herhangi bir istek yapmadan önce mevcut bir dizi duraklamayı temsil eder.

1. Check access and current cost

SDK için kontrol edin ve çalıştırın. Bu, izinleri, dengeyi ve bir Google Search fiyatını okur. Access check geçtikten sonra devam edin; bu çekler ücretli bir sorgu veya rezerv kredisi sunmaz.

check_access.py
import os
import sys
from flashdata import FlashData, APIError

def main():
    key = os.environ.get("FLASHDATA_API_KEY", "").strip()
    if not key:
        raise RuntimeError("Set FLASHDATA_API_KEY in this terminal.")
    with FlashData(api_key=key) as client:
        access = client.account.access()
        if "google_search" not in access["sources"]:
            raise RuntimeError("This key needs google_search permission.")
        balance = client.account.balance()
        pricing = client.account.pricing(source="google_search", request_count=1)
    price = next((p for p in pricing["prices"]
                  if p["source"] == "google_search" and p["available"]), None)
    cost = price.get("estimatedCredits") if price else None
    if cost is None:
        raise RuntimeError("No current price is available; stop here.")
    available = balance["availableCredits"]
    print(f"Available credits: {available}")
    print(f"One search: {cost} credits")
    if available < cost:
        raise RuntimeError("Insufficient credits. Review Billing.")
    print("Access check passed. No paid query submitted.")

if __name__ == "__main__":
    try:
        main()
    except APIError as error:
        print(f"HTTP {error.status_code}; code={error.code}; "
              f"request_id={error.request_id}; Retry-After={error.retry_after}",
              file=sys.stderr)
        sys.exit(1)
    except Exception as error:
        print(f"{type(error).__name__}: {error}", file=sys.stderr)
        sys.exit(1)
Linux / macOS
.venv/bin/python check_access.py
Windows PowerShell
.\.venv\Scripts\python.exe check_access.py

2. Yeni bir çıkış rehberi ile Run with a new print directory

Kontrol geçtikten sonra bu programlardan birini çalıştırın. Teklif etmeden önce rehberi yaratır, istek kaydeder, sonra cevabı kurtarır. Başarısızlık üzerine dizin tutun: Onu silme veya yeni bir tane seçme başka bir faturalanabilir sorguya izin verir.

archive_search.py
import json
import os
import sys
from datetime import datetime, timezone
from pathlib import Path
from flashdata import FlashData, APIError, SubmissionUnknownError

def main():
    key = os.environ.get("FLASHDATA_API_KEY", "").strip()
    if not key:
        raise RuntimeError("Set FLASHDATA_API_KEY before running.")
    directory = Path(sys.argv[1] if len(sys.argv) > 1 else "runs/research-001")
    directory.mkdir(mode=0o700, parents=True, exist_ok=False)

    def save(name, value):
        with (directory / name).open("x", encoding="utf-8") as output:
            json.dump(value, output, ensure_ascii=False, indent=2)

    request = {"source": "google_search", "query": "battery recycling research",
               "params": {"num": 5}}
    save("request.json", request)
    save("intent.json", {"state": "dispatching",
                         "startedAt": datetime.now(timezone.utc).isoformat()})
    try:
        with FlashData(api_key=key) as client:
            response = client.google.search(request["query"], **request["params"])
    except (APIError, SubmissionUnknownError) as error:
        detail = {"kind": type(error).__name__}
        if isinstance(error, APIError):
            detail.update(code=error.code, httpStatus=error.status_code,
                          requestId=error.request_id, retryAfter=error.retry_after)
        save("error.json", detail)
        raise RuntimeError("Inspect the saved attempt and History before retrying.") from None
    save("result.json", response)
    if response.get("status") != "done":
        raise RuntimeError("Response saved; inspect its status before proceeding.")
    print("Saved:", directory / "result.json")
    print("Usage:", response.get("usage"))

if __name__ == "__main__":
    try:
        main()
    except Exception as error:
        print(f"{type(error).__name__}: {error}", file=sys.stderr)
        sys.exit(1)
Linux / macOS
.venv/bin/python archive_search.py runs/research-001
Windows PowerShell
.\.venv\Scripts\python.exe archive_search.py runs/research-001

Beklenmiş dosyalar

Başarı durumunda kaydedilen sonuç yolu ve kullanım yazdırılır. result.json içinde status: done bulunmalıdır; Google sonuçları results[].organic[] içindedir. Boş organic dizisi geçerlidir. Bildirilen API veya aktarım hatası error.json içine kaydedilir; intent.json ilk gönderim öncesi kaydı olarak kalır.

Başarılı deneme
runs/research-001/
  request.json # Kaynağı, sorgu ve parametreler
  intent.json # girişim zaman başlar
  result.json # Sonuçlar ve kullanım dahil olmak üzere tam yanıt

3. Kurtarılan Çıktıyı Oku

Ayrıştırma, özetleme ve UI çalışmaları için result.json dosyasını okuyun. Bu komutlar yalnızca yerel dosyaları kullanır. Aramayı aynı klasörde tekrarlamak ağ çağrısından önce durur; farklı makineleri koordine etmez veya kaybolan sunucu yanıtını kurtarmaz.

Yerel olarak okuyun
cat runs/research-001/result.json

Bir başarısızlıktan sonra ne yapacağını karar verin

Sahip olduğunuz şeySonraki eylem
Varing directory / EEXISTDosyalarını göz önünde bulundurun. Bu girişim tarafından yeni bir sorgu gönderilmedi.
result.json, status: doneKurtarılan cevabı okuyun ve işlem. Kullanımını orijinal ücretin bir makbulu olarak kullanın.
error.json ile 401 / 403 / 402Yeni bir deneme planlamadan önce kaynak izinleri veya dengeyi düzeltin.
429 / retryAfterTalep oranını talimat olarak bekleyin ve azaltın. Yeni bir run directory seçmeden önce başarısız denemeyi gözden geçirin.
Bilinmeyen gönderim / niyet sadece / yazma başarısızlıkİş zaten kabul edilebilir. Rehberi tutun ve History veya bilinen bir iş ID'u başka bir sorgu göndermeden önce kontrol edin.

Async müşterileri ve arka plan işleri

İhtiyaç ihtiyacına ihtiyaç varKullanım
Bir olay döngüsüne duyarlı olSDK'un async müşterisi / aramaları bekliyor. Gerçek zamanlı bir sorgu hala HTTP cevabında tamamlanıyor.
Çağrı süreci çıkışından sonra ResumeBir arka plan işini bir kez gönderin, uzak ID'unu kurtar, sonra durumu ve sonuçları okuyun.
Bir programda Run on a scheduleSahibi erişim ve kalıcı uygulama kayıtları kullanın veya CLI'nun mevcut iş dergileri.