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

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

เริ่มต้นอย่างรวดเร็ว

เรียกใช้การค้นหา Google ครั้งแรกและรับผลลัพธ์แบบมีโครงสร้างสำหรับแอปหรือเอเจนต์ AI ของคุณ

เริ่มต้นด้วยเอเจนต์ AI

ส่งพรอมป์ต์นี้ให้เอเจนต์ที่ใช้เทอร์มินัลได้ เอเจนต์จะตั้งค่า FlashData และค้นหาหนึ่งครั้ง

เรียก API ครั้งแรก

ต้องการเขียนโค้ดเองหรือไม่? ทำตามสามขั้นตอนนี้ในเทอร์มินัล

  1. รับคีย์ API

    สร้างบัญชี ยืนยันอีเมล และสร้างคีย์ที่มีสิทธิ์ Google Search หากมีคีย์ที่เหมาะสมอยู่แล้วให้ใช้คีย์เดิม

    รันในเทอร์มินัลแล้ววางคีย์เมื่อระบบขอ โดยข้อความที่ป้อนจะถูกซ่อน ข้ามขั้นตอนนี้หากตั้งค่า FLASHDATA_API_KEY แล้ว

    ตั้งค่าคีย์
    # 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. เรียกใช้การค้นหา

    เลือกภาษาและรันตัวอย่างในเทอร์มินัลเดิม การรันแต่ละครั้งจะส่งการค้นหาหนึ่งครั้ง

    Python 3.10+ · บันทึกตัวอย่างเป็น quickstart.py

    ติดตั้ง
    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))
    เรียกใช้
    python quickstart.py
  3. ตรวจสอบผลลัพธ์

    คำตอบที่สำเร็จมี status: done แหล่งข้อมูลอยู่ใน results[].organic และเครดิตที่คิดค่าบริการอยู่ใน usage.credits

    ตัวอย่างการตอบกลับ (ย่อ)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

ลองใช้คอนโซล

  1. สร้างบัญชีหรือเข้าสู่ระบบ ยืนยันอีเมลและทำตามขั้นตอนตั้งค่าบัญชีที่แสดงในคอนโซล
  2. เปิด Google Search เลือกแหล่งข้อมูล Google Search และโหมด Realtime แล้วป้อน battery recycling research ขยาย Additional parameters และตั้งค่า Page size (num) เป็น 5
  3. ตรวจสอบคำขอที่แสดงและเครดิตที่มี แล้วค้นหาหนึ่งครั้ง
  4. ตรวจสอบคำตอบและการใช้งาน เปิดแหล่งข้อมูลที่ได้รับเพื่อตรวจสอบเนื้อหาก่อนอ้างอิงข้อมูลที่เกินกว่าข้อความตัวอย่าง

ต่อยอดจากผลลัพธ์แรก

หากคำขอแรกไม่สำเร็จ

ไม่ได้ตั้งค่า FLASHDATA_API_KEY
ตั้งค่าคีย์ในเทอร์มินัลหรือรันไทม์เดียวกับตัวอย่าง ตัวอย่างเหล่านี้ไม่อ่านไฟล์ .env
401 / 403
ตรวจสอบว่าคีย์หรือการเชื่อมต่อยังใช้งานอยู่และมีสิทธิ์ google_search
402
ตรวจสอบเครดิตที่ใช้ได้ใน Billing หากต้องการสิทธิ์ของเจ้าของบัญชี ให้เชื่อมโยงการทดลองใช้เดิมกับบัญชี
429
ปฏิบัติตาม Retry-After ใช้ตัวตนและหลักฐานการลงทะเบียนเดิม อย่าสร้างการทดลองใช้อีกบัญชี
หมดเวลาหรือไม่ทราบสถานะการส่ง
ตรวจสอบการรันเดิมก่อนลองอีกครั้ง ผู้ใช้ CLI ต้องเก็บโปรไฟล์และ ID การรันเดิม ส่วนผู้ใช้ SDK/API ต้องบันทึก ID งานหรือคำขอที่ได้รับ