Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Mulai

Pemeriksaan akun dan hasil tersimpan dengan SDK

Periksa biaya, simpan catatan setiap usaha dan baca hasil tersimpan tanpa panggilan API lain.

Di halaman ini

Sebelum Anda mulai

Gunakan proyek ini, instal SDK dan FLASHDATA_API_KEY dari awalan cepat SDK anda. Pilih satu bahasa di bawah ini. Setiap direktori lari baru mewakili satu pencarian yang dimaksudkan; memakai kembali direktori yang telah ada berhenti sebelum membuat permintaan apapun.

1. Periksa biaya akses dan kini

Simpan dan jalankan cek untuk SDK Anda. Ini membaca hak, keseimbangan dan harga dari satu Google Search. Lanjutkan hanya setelah pemeriksaan Akses dilewatkan; pemeriksaan ini tidak mengirimkan kredit terbayar atau cadangan.

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 keluaran baru

Jalankan salah satu program ini setelah check pass. Ini menciptakan direktori sebelum mengirimkan, merekam permintaan, kemudian menyimpan respon. Pertahankan direktori pada kegagalan: menghapusnya atau memilih yang baru memungkinkan kuiri yang lain.

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

Diduga berkas

Cetakan hasil yang tersimpan dari jalur dan penggunaan. result.json seharusnya memiliki status: done; Hasil Google berada dalam results[].organic[]. Array organik yang kosong valid. Sebuah laporan API atau kesalahan transport disimpan ke error.json; intent.json tetap menjadi catatan awal sebelum pengajuan.

Usaha yang sukses
runs/research-001/
  request.json   # Sumber, permintaan dan parameter
  intent.json # Percobaan awal waktu
  result.json # Respon penuh, termasuk hasil dan penggunaan

3. Baca keluaran yang disimpan

Baca result.json untuk parsing, ringkasan dan UI bekerja. Perintah-perintah ini hanya menggunakan berkas lokal. Memulihkan pencarian dengan direktori yang sama berhenti sebelum panggilan jaringan; ini tidak mengkoordinasikan mesin yang berbeda atau memulihkan respon server yang hilang.

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

Putuskan apa yang harus dilakukan setelah kegagalan

Apa yang Anda milikiAksi berikutnya
Direktori / EEXIST yang adaPeriksa berkasnya. Tidak ada permintaan baru yang dikirim oleh upaya ini.
result.json, status: doneBaca dan proses respon yang disimpan. Gunakan kembali penggunaannya sebagai tanda terima dari muatan asli.
error.json dengan 401 / 403 / 402Perbaiki akses, perizinan sumber atau keseimbangan sebelum merencanakan percobaan baru.
429 / retryAfterTunggu seperti yang diperintahkan dan kurangi tingkat permintaan. Tinjau percobaan gagal sebelum memilih direktori lari baru.
Pengiriman / tujuan saja / tulis kegagalan tidak diketahuiPekerjaan mungkin sudah diterima. Pertahankan direktori dan periksa History atau pekerjaan yang dikenal ID sebelum mengirim kueri lain.

Async klien dan pekerjaan latar belakang

PerluGunakan
Jauhkan sebuah loop event responsifThe SDKKlien async menunggu panggilan. Query real time masih lengkap dalam respon HTTP nya.
Lanjutkan setelah proses panggilan keluarKirim suatu pekerjaan latar belakang sekali, simpan remote ID, kemudian baca status dan hasil.
Jalankan sesuai jadwalGunakan akses pemilik dan rekam aplikasi dapat ditahan, atau CLIJurnal yang ada.