Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Mula di sini

Semakan akaun dan hasil tersimpan dengan SDK

biaya pemeriksaan , menyimpan catatan setiap percobaan dan membaca hasil yang disimpan tanpa panggilan API lain.

Pada halaman ini

Sebelum kau mulai

Guna proyek tersebut, terpasang SDK dan FLASHDATA_API_KEY dari SDK quickstart anda. Pilih satu bahasa di bawah ini. Setiap direktori run baru mewakili satu pencarian yang dimaksudkan; menggunakan kembali direktori yang ada berhenti sebelum membuat permintaan apapun.

1. Periksa akses dan biaya saat ini

Simpan dan jalankan cek untuk SDK. Ia membaca izin, keseimbangan dan harga satu Google Search. Hanya dilanjutkan setelah pemeriksaan Access lulus; pemeriksaan ini tidak mengajukan kredit kueri atau cadangan yang telah dibayar.

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. Jalankan dengan direktori output baru

Jalankan salah satu program ini setelah pemeriksaan lulus. Ini menciptakan direktori sebelum mengajukan, mencatat permintaan, kemudian menyimpan respon. Simpan direktori pada kegagalan: menghapusnya atau memilih yang baru memungkinkan pertanyaan yang dapat diagihkan lagi.

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

Semua berkas yang diharapkan

Kejayaan mencetak jalur dan penggunaan hasil yang disimpan. result.json harus memiliki status: done; Hasil Google berada di results[].organic[]. Sebuah susunan organik kosong adalah valid. Sebuah API yang dilaporkan atau kesalahan transportasi disimpan ke error.json; intent.json tetap merupakan catatan awal pengiriman.

Usaha yang sukses
runs/research-001/
  request.json   Sumber, pertanyaan dan parameter
  intent.json    Mencoba waktu mulai percobaan
  XAresult.json # Respon penuh, termasuk hasil dan penggunaan

3. Keluaran tersimpan Read Kebocoran

Kemudia baca result.json untuk parsing, summaries dan UI kerja. Perintah-perintah ini hanya menggunakan berkas lokal. Alokasi ulang pencarian dengan stop direktori yang sama sebelum panggilan jaringan; tidak berkoordinasi dengan mesin yang berbeda atau memulihkan respon server yang hilang.

Baca secara lokal
cat runs/research-001/result.json

Memutuskan apa yang harus dilakukan setelah kegagalan

Apa yang Anda milikiTindakan berikutnya
Direktori / EEXIST TerwujudPeriksa berkasnya. Tidak ada pertanyaan baru yang dikirim oleh upaya ini.
result.json, status: doneBaca dan proses respon yang disimpan. Reacuuse penggunaannya sebagai penerimaan dari muatan asli.
error.json dengan 401 / 403 / 402Fix akses, hak sumber atau keseimbangan sebelum merencanakan upaya baru.
429 / retryAfter- Tunggu seperti yang diperintahkan dan kurangi nilai permintaan. Tinjau upaya gagal sebelum memilih direktori lari baru.
Pengiriman / niatan hanya / gagal menulis tidak diketahuiPekerjaan kinologi mungkin sudah diterima. ¡Keep the directory and inspect History atau pekerjaan yang diketahui IDQ sebelum mengirim pertanyaan lain.

Klien Async dan pekerjaan latar belakang

Perlunya KebutuhanGuna
ULANGLAHLAH agar lingkaran acara tanggapSDK's async client / menunggu panggilan. Sebuah pertanyaan realtime masih lengkap dalam respon HTTP.
Kembali setelah proses pemanggilan keluarBerikan pekerjaan latar belakang sekali, simpan remote ID, lalu baca status dan hasilnya.
Jalankan mengikut jadualGuna akses pemilik dan aplikasi tahan lama menjalankan catatan, atau jurnal jangka CLI yang sudah ada.