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

Bắt đầu

Bắt đầu nhanh

Chạy lượt tìm kiếm Google đầu tiên và nhận kết quả có cấu trúc cho ứng dụng hoặc tác nhân AI của bạn.

Bắt đầu với tác nhân AI

Gửi câu lệnh này cho tác nhân có quyền dùng terminal. Tác nhân sẽ thiết lập FlashData và chạy một lượt tìm kiếm.

Thực hiện lệnh gọi API đầu tiên

Muốn tự viết mã? Làm theo ba bước sau trong terminal.

  1. Lấy khóa API

    Tạo tài khoản, xác minh email rồi tạo khóa có quyền Google Search. Nếu đã có khóa phù hợp, hãy dùng lại.

    Chạy trong terminal và dán khóa vào lời nhắc nhập ẩn. Bỏ qua nếu FLASHDATA_API_KEY đã được đặt.

    Đặt khóa
    # Bash: paste the key into a hidden prompt, not into this command.
    read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
    printf '\n'
    export FLASHDATA_API_KEY
  2. Chạy tìm kiếm

    Chọn ngôn ngữ và chạy ví dụ trong cùng terminal. Mỗi lần chạy sẽ gửi một lượt tìm kiếm.

    Python 3.10+ · Lưu ví dụ thành quickstart.py.

    Cài đặt
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    import json
    import os
    from flashdata import FlashData
    
    with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        print(json.dumps(response, indent=2))
    Chạy
    python quickstart.py
  3. Kiểm tra kết quả

    Phản hồi thành công có status: done. Nguồn nằm trong results[].organic và tín dụng đã tính nằm trong usage.credits.

    Phản hồi mẫu (rút gọn)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

Thử bảng điều khiển

  1. Tạo tài khoản hoặc đăng nhập. Hoàn tất xác minh email và các bước thiết lập tài khoản được hiển thị trong bảng điều khiển.
  2. Mở Google Search, chọn nguồn Google Search và chế độ Realtime, rồi nhập battery recycling research. Mở Additional parameters và đặt Page size (num) thành 5.
  3. Kiểm tra yêu cầu hiển thị và tín dụng khả dụng, sau đó chạy tìm kiếm một lần.
  4. Kiểm tra phản hồi và mức sử dụng. Mở nguồn được trả về để xác minh nội dung trước khi trích dẫn thông tin ngoài đoạn trích.

Phát triển từ kết quả đầu tiên

Nếu yêu cầu đầu tiên thất bại

Thiếu FLASHDATA_API_KEY
Đặt khóa trong cùng terminal hoặc môi trường chạy ví dụ. Các đoạn mã này không đọc tệp .env.
401 / 403
Kiểm tra khóa hoặc kết nối đang hoạt động và có quyền google_search.
402
Kiểm tra tín dụng khả dụng trong Billing. Liên kết lượt dùng thử hiện có với tài khoản nếu cần quyền của chủ sở hữu.
429
Tuân theo Retry-After. Giữ nguyên danh tính và bằng chứng đăng ký; không tạo lượt dùng thử khác.
Hết thời gian chờ hoặc chưa rõ trạng thái gửi
Kiểm tra lần chạy hiện có trước khi thử lại. Người dùng CLI cần giữ nguyên hồ sơ và ID lần chạy; người dùng SDK/API cần lưu ID tác vụ hoặc yêu cầu được trả về.