ข้ามไปยังเนื้อหา
TH
รับคีย์ API
เรียกดูเอกสาร

เริ่มต้นใช้งาน

ตรวจสอบบัญชีและผลลัพธ์ที่บันทึกด้วย SDK

Check ค่าใช้จ่ายเก็บไว้บันทึกของแต่ละความพยายามและการอ่านผลลัพธ์โดยไม่ต้องอื่น API โทรสิ

ในหน้านี้

ก่อนจะเริ่ม

ใช้โครงการที่ถูกติดตั้งแล้ว SDK ถึง FLASHDATA_API_KEY จากเธอ SDK สตาร์ทเร็ว เลือกหนึ่งภาษาด้านล่างนี้ ไดเร็คทอรีสําหรับประมวลผลตัวใหม่แต่ละตัว จะใช้การค้นหาที่ตั้งใจไว้; ทําการหยุดไดเรกทอรีที่มีอยู่ก่อนจะทําการร้องขอ

1. ตรวจสอบสิทธิ์และค่าใช้จ่ายปัจจุบัน

บันทึกและเรียกตรวจสอบสําหรับ SDK ของคุณ มันอ่านสิทธิ์ที่อนุญาต ดุลยภาพ และราคาของ Google Search ทําต่อไปหลังจากผ่านการตรวจสอบการเข้าใช้แล้วเท่านั้น เช็คเหล่านี้ไม่ส่งข้อมูลที่ร้องขอมา หรือหน่วยกิตสํารอง

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. ประมวลผลด้วยไดเรกทอรีส่งออกเสียงตัวใหม่

ประมวลผลโปรแกรมเหล่านี้ โปรแกรมหนึ่งหลังจากการตรวจสอบผ่าน มันสร้างไดเร็กทอรีก่อนที่จะส่งข้อมูล บันทึกคําขอ แล้วบันทึกการตอบสนอง เก็บไดเรกทอรีไว้เมื่อล้มเหลว: การลบหรือเลือกไดเรกทอรีใหม่ จะเป็นการอนุญาตให้สอบถามได้ง่ายขึ้น

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

แฟ้มที่ต้องการ

พิมพ์ผลการค้นหาเส้นทางและการใช้งานของผลลัพธ์ที่บันทึกไว้ result.json ควรจะมี status: done; Google ผลที่ได้คือ results[].organic[]. อินทรีย์อาร์เรย์ว่างใช้ได้ รายงาน API จัดเก็บข้อผิดพลาดในการรับส่งข้อมูลไปยัง error.json; intent.json ยังเป็นประวัติเดิมก่อนการรับราชการ

การพยายามเสร็จสมบูรณ์
runs/research-001/
  request.json # แหล่งที่มา, สืบค้นและพารามิเตอร์
  intent.json # พยายามเริ่มเวลา
  result.json    # ตอบสนองเต็มที่ รวมทั้งผลลัพธ์และการใช้งาน

3. อ่านผลลัพธ์ที่บันทึกไว้

อ่าน result.json สําหรับ partsing, ผลรวมและงาน UI คําสั่งเหล่านี้ใช้เฉพาะแฟ้มภายในระบบเท่านั้น ทําการค้นหาใหม่อีกครั้ง โดยใช้ไดเร็กทอรีเดียวกันนี้หยุดก่อนที่จะมีการเรียกจากเครือข่าย มันไม่ได้ประสานงานกับเครื่องอื่น ๆ หรือเรียกคืนการตอบกลับของแม่ข่ายหาย

อ่านภายในเครื่อง
cat runs/research-001/result.json

จง ตัดสิน ใจ ว่า จะ ทํา อย่าง ไร หลัง จาก ล้ม เหลว

สิ่งที่คุณมีการกระทําถัดไป
มีไดเร็กทอรีอยู่ / esEXistจําแนกแฟ้ม ไม่มีการส่งคําร้องขอใหม่จากความพยายามนี้
result.json, status: doneอ่านและประมวลผลการตอบสนองที่บันทึกไว้ ใช้การนําไปใช้เป็นใบเสร็จ ของค่าใช้จ่ายเดิม
error.json ด้วย 401 / 403 / 402ปรับแก้สิทธิ์ในการใช้งาน, สิทธิ์ที่แหล่งหรือดุลยภาพ ก่อนที่จะมีการวางแผนใหม่
429 / retryAfterรอฟังคําสั่งและลดอัตราการขอ ทบทวนความพยายามที่ล้มเหลวก่อนที่จะเลือกไดเรกทอรีสําหรับประมวลผลตัวใหม่
ไม่รู้จักการส่งข้อมูล / วัตถุประสงค์ / เขียนเท่านั้นล้มเหลวงาน อาจ ได้ รับ การ ยอม รับ แล้ว. เก็บไดเรกทอรีและตรวจสอบ History หรืองานที่รู้จักดี ID ก่อนที่จะส่งคําถามอีก

Async โปรแกรมลูกข่ายและงานเบื้องหลัง

ต้องการใช้
คงการเรียกดูเหตุการณ์ต่าง ๆ ไว้เดอะ SDKลูกค้าของแอสซิงค์ / รอสาย การสอบถามตามเวลาจริงยังคงเสร็จสมบูรณ์ใน HTTP ตอบสนอง
ทําต่อหลังจากจบโพรเซสการเรียกส่งข้อมูลพื้นหลังอีกครั้ง โดยบันทึกค่าระยะไกลไว้ IDจากนั้นก็อ่านสถานะและผล
ประมวลผลตามตารางใช้สิทธิ์ของเจ้าของและใช้กับโปรแกรมที่ทนทาน เพื่อเรียกเก็บบันทึกการทํางานหรือ CLIมีบันทึกการทํางานอยู่แล้ว