Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Bắt đầu

Kiểm tra tài khoản và kết quả đã lưu bằng SDK

Kiểm tra chi phí, ghi lại từng nỗ lực và đọc kết quả đã lưu mà không có một kết quả khác API Gọi đi.

Trên trang này

Trước khi bắt đầu

Dùng dự án đã cài đặt SDK và FLASHDATA_API_KEY của bạn SDK Khởi động nhanh. Chọn một ngôn ngữ bên dưới. Mỗi thư mục chạy mới tượng trưng cho một việc tìm kiếm đã định; sử dụng lại một thư mục đã có trước khi yêu cầu.

1. Kiểm tra quyền truy cập và chi phí hiện tại

Lưu và chạy kiểm tra cho của bạn SDK. Nó đọc quyền hạn, sự số dư và giá của một Google Search. Tiếp tục chỉ sau khi kiểm tra truy cập được qua; những kiểm tra này không gửi một truy vấn hoặc tín dụng dự trữ được trả tiền.

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. Chạy với thư mục xuất mới

Chạy một trong những chương trình này sau khi kiểm tra xong. Nó tạo thư mục trước khi gửi, ghi lại yêu cầu, rồi lưu lại câu trả lời. Giữ thư mục vào thất bại: xoá nó hoặc chọn một điều mới cho phép một yêu cầu có thể tính toán khác.

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

Mong đợi tập tin

Thành công in đường dẫn và sử dụng kết quả đã lưu. result.json nên có status: done; Google Kết quả rồi. results[].organic[]. Một hệ thống hữu cơ rỗng là hợp lệ. Một báo cáo API hoặc lỗi giao thông được lưu error.json; intent.json Vẫn còn lại hồ sơ ban đầu.

Thành công trong nỗ lực
runs/research-001/
  request.json # Nguồn, truy vấn và tham số
  intent.json # Cố gắng bắt đầu thời gian
  result.json # Đáp ứng đầy đủ, bao gồm kết quả và sử dụng

3. Đọc kết xuất đã lưu

Đọc result.json Để phân tích, tóm tắt và làm việc ở UI. Những lệnh này chỉ dùng tập tin cục bộ. Chạy lại việc tìm kiếm với cùng một thư mục dừng lại trước khi gọi đến mạng; nó không phối hợp các máy khác nhau hoặc phục hồi một trả lời máy chủ bị mất.

Đọc ở địa phương
cat runs/research-001/result.json

Hãy quyết định phải làm gì sau khi thất bại

Những gì bạn cóHành động tiếp theo
Thư mục tồn tại / EEXSTKiểm tra hồ sơ của nó. Không có yêu cầu mới nào được gửi bằng nỗ lực này.
result.json, status: doneĐọc và xử lý phản ứng đã được cứu. Dùng lại nó làm biên nhận của điện gốc.
error.json có 401 / 403 / 402Sửa quyền truy cập, quyền truy cập nguồn hoặc số dư trước khi lên kế hoạch một nỗ lực mới.
429 / retryAfterHãy chờ theo hướng dẫn và giảm mức yêu cầu. Xem lại việc thử đã thất bại trước khi chọn thư mục chạy mới.
Không biết phục tùng / mục đích chỉ / ghi thất bạiCông việc có thể đã được chấp nhận rồi. Giữ thư mục và thanh tra History hoặc một công việc đã biết ID Trước khi gửi một truy vấn khác.

Async Khách hàng và công việc nền

CầnDùng
Giữ một vòng lặp sự kiện trả lờiHạt SDKMột khách hàng đặc biệt, đang chờ điện thoại. Một truy vấn thời gian thực vẫn hoàn thành trong phản ứng HTTP của nó.
Tiếp tục sau khi tiến trình gọi thoátGửi một công việc nền một lần, lưu từ xa IDSau đó đọc địa vị và kết quả.
Chạy theo lịchSử dụng quyền truy cập của người sở hữu và các ứng dụng bền bỉ chạy các hồ sơ, hoặc các CLINhật ký chạy của chạy hiện tại.