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

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

เริ่มต้นใช้ Python SDK

ติดตั้ง Python SDK และพิมพ์ผลการค้นหาด้วยรหัสไม่กี่บรรทัด รวม เอา ตัว อย่าง ที่ ประสาน ลง รอย กัน และ สัมฤ ทธิ ผล.

  1. ติดตั้ง SDK

    ต้องการ Python 3.10+. ประมวลผลคําสั่งเหล่านี้ในไดเรกทอรีโครงการของคุณ ใช้สภาพแวดล้อมเสมือนแล้วหรือไม่? ติดตั้งแฟลชดาต้า==1.1.0 กับสภาพแวดล้อมที่ python -m pip แทน

    ติดตั้ง
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. การตรวจสอบสิทธิ์

    สร้างรายการ API กุญแจพร้อม Google Search อนุญาตหรือใช้กุญแจที่ได้รับอนุญาตอีกครั้ง ตั้งมันไว้ในเทอร์มินัลนี้ โดยใช้ตัวเรียกซ่อนด้านล่างนี้

    ข้ามการแจ้งเตือนถ้า FLASHDATA_API_KEY ได้ตั้งค่าแล้ว ตัวอย่างเหล่านี้อ่านตัวแปรโดยตรง; มันไม่โหลดแฟ้ม .env

    แจ้งเตือนปุ่มซ่อน as Bash
    # 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
  3. เรียกใช้การค้นหา

    บันทึกนี้ให้เป็น quickstart.py แล้วเรียกใช้งานมันด้วยสภาพแวดล้อมเสมือนเดียวกัน มันสร้างได้ Google Search ร้องขอผล 5 อย่าง และชื่อพิมพ์ URLs และใช้เครดิต

    quickstart.py
    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)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])
    เรียกใช้
    .venv/bin/python quickstart.py
  4. ตรวจสอบผลลัพธ์

    สคริปต์ออกปกติหลังจากตรวจสอบสถานะเสร็จแล้ว ชื่อแหล่งที่ต้องการและ URLs ตามด้วยชื่อที่อยู่ รายการออร์แกนิคว่างเป็นการตอบสนองที่ถูกต้อง ผลต่าง ๆ ที่เกิดขึ้นกับคําร้องขอของคุณ

    ตัวอย่างผลลัพธ์
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].organic[]
    Google Search. ฮิต: หัวเรื่อง, ลิงก์และชิ้นส่วน แหล่ง อื่น ๆ มี ผล งาน ต่าง กัน.
    usage.credits
    ค่าใช้จ่ายของคําขอนี้ ได้ผลลัพธ์ 5 อย่างแล้ว นี่คือคําขอค้นหาหนึ่งข้อ

ลองแหล่งข้อมูลอื่น

แต่ละแท็บเป็นสคริปต์ที่สมบูรณ์ แทนที่ quickstart.py ด้วยตัวอย่างหนึ่งและเรียกใช้ด้วยคําสั่งจากขั้นตอน 3. แต่ละการทํางานจะส่งการร้องขอใหม่หนึ่งตัว; กุญแจต้องการสิทธิ์ในการแสดงแหล่งข้อมูล

ต้องการ google_news พิมพ์ชื่อบทความและที่อยู่เชื่อมโยงจากบทความ results[].news[].

quickstart.py
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.news("battery recycling", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for article in page.get("news", []):
            print(article.get("title"), article.get("link"))

อะไรกันนี่ Python SDK สนับสนุน

google / youtube
Google Search, News, image, Stople, Videos and Pages; YouTube. การค้นพบข้อมูลกํากับ, คําบรรยาย, สําเนาและข้อมูลของช่อง
youtube.download
ส่งงานส่งเสียงหรือวิดีโอไปยังที่เก็บเมฆของคุณ ต้องการ youtube_download อนุญาตให้ใช้และบันทึกการปรับแต่ง; ปฏิบัติตามตัวอย่างการดาวน์โหลดที่สมบูรณ์ด้านล่างนี้
jobs / bulk
บันทึกงานที่ยอมรับแล้ว ID, รอให้เสร็จสมบูรณ์และรับผล ใช้ขนาดใหญ่สําหรับวิดีโอ- ID ชุดข้อมูลและทํางานต่อหลังจากเริ่มการทํางานใหม่
account
อ่าน เข้าถึง, สมดุล, ประเมินค่า, จํากัด และการใช้งาน ก่อนการทํางานซ้ํา ใช้กุญแจที่ได้รับอนุญาตจากสภาพแวดล้อมหรือร้านค้าลับของคุณ
respond_with / accept
ใช้ respond_with="markdown" สําหรับ Markdown ในการตอบรับ ["content"หรือยอมรับก็ได้"text/plain" สําหรับเชือก JSON พจนานุกรมเป็นค่าปริยาย

ใช้ Asynio

แทนที่ quickstart.py ด้วยเวอร์ชันนี้ และใช้คําสั่งประมวลผลเดียวกัน Async Fashdate Data เปิดเผยทรัพยากรเดียวกัน ด้วยความรอคอย นี้ยังคงรอการตอบรับตามเวลาจริง; mode="async" ส่งงานเบื้องหลังของแม่ข่ายแทน

ใน Jupyter หรือโปรแกรมที่มีวนรอบเหตุการณ์ ทํางาน ให้ใช้รอฟังก์ชันหลักแทน asyncio.run(Mayal ()) ใช้โปรแกรมลูกข่ายภายในวงจรเหตุการณ์นั้นอีกครั้ง

quickstart.py
import asyncio
import os
from flashdata import AsyncFlashData

async def main():
    async with AsyncFlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = await client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])

asyncio.run(main())

ถัดไป

ถ้าขั้นตอนล้มเหลว

ModuleNotFoundError
ติดตั้งและประมวลผลด้วยล่ามเดียวกัน: .venv/bin/python - อืม pip แสดงแฟลชดาต้า (hadata)Windows: .\.venv\Scripts\python.exe - อืม pip แสดงแฟลชดาต้า). ไม่ต้องตั้งชื่อสคริปต์ของคุณ flashdata.py
KeyError: FLASHDATA_API_KEY / 401
ตั้งค่าที่ใช้งานอยู่ API กุญแจในอาคารเดียวกัน แฟ้ม .env เท่านั้นที่ไม่ได้โหลดโดยตัวอย่างนี้ ใช้ API กุญแจ ไม่ใช่ MCP OAuth เซ็นต์นี่
403
อนุมัติแหล่งกําเนิดที่ต้องการโดยตัวอย่างกุญแจนี้
402
ตรวจสอบ Billing สําหรับเครดิตที่มีอยู่ หาก เข้าถึง การทดลอง หมด สิ้น จง อ้าง ว่า การ เชื่อม โยง นั้น เกี่ยว ข้อง กับ การ ใช้ ความ สมดุล ของ บัญชี.
429 / APIError
Inspect error.retry_after และลดอัตราการร้องขอ SDK ส่งการร้องขอแต่ละครั้งและไม่มีการลองใหม่โดยอัตโนมัติ
SubmissionUnknownError
การส่งเวลานอก อาจเป็นที่ยอมรับแล้ว ตรวจสอบ History ก่อนที่จะทําซ้ํา; ทํางานที่บันทึกไว้อีกครั้ง ID เมื่อมีให้ใช้
asyncio.run() / running event loop
ใช้การรอข้อความหลักในบันทึก หรือวนรอบเหตุการณ์ที่มีอยู่ เก็บไว้ asyncio.run(ข้อความหลัก) สําหรับสคริปต์แบบยืนยง