เรียกดูเอกสาร
เริ่มต้นใช้งาน
ติดตั้ง Python SDK และพิมพ์ผลการค้นหาด้วยรหัสไม่กี่บรรทัด รวม เอา ตัว อย่าง ที่ ประสาน ลง รอย กัน และ สัมฤ ทธิ ผล.
ติดตั้ง SDK
ต้องการ Python 3.10+. ประมวลผลคําสั่งเหล่านี้ในไดเรกทอรีโครงการของคุณ ใช้สภาพแวดล้อมเสมือนแล้วหรือไม่? ติดตั้งแฟลชดาต้า==1.1.0 กับสภาพแวดล้อมที่ python -m pip แทน
ติดตั้งpython3 -m venv .venv .venv/bin/python -m pip install "flashdata==1.1.0"ติดตั้งpy -3 -m venv .venv .\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"การตรวจสอบสิทธิ์
สร้างรายการ 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แจ้งเตือนปุ่มซ่อน as PowerShell# PowerShell 7: paste the key into a hidden prompt. $flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString $env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password Remove-Variable flashdataSecureKeyเรียกใช้การค้นหา
บันทึกนี้ให้เป็น quickstart.py แล้วเรียกใช้งานมันด้วยสภาพแวดล้อมเสมือนเดียวกัน มันสร้างได้ Google Search ร้องขอผล 5 อย่าง และชื่อพิมพ์ URLs และใช้เครดิต
quickstart.pyimport 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เรียกใช้.\.venv\Scripts\python.exe quickstart.pyตรวจสอบผลลัพธ์
สคริปต์ออกปกติหลังจากตรวจสอบสถานะเสร็จแล้ว ชื่อแหล่งที่ต้องการและ URLs ตามด้วยชื่อที่อยู่ รายการออร์แกนิคว่างเป็นการตอบสนองที่ถูกต้อง ผลต่าง ๆ ที่เกิดขึ้นกับคําร้องขอของคุณ
ตัวอย่างผลลัพธ์Battery recycling research https://example.org/recycling Credits used: 0.02results[].organic[]- Google Search. ฮิต: หัวเรื่อง, ลิงก์และชิ้นส่วน แหล่ง อื่น ๆ มี ผล งาน ต่าง กัน.
usage.credits- ค่าใช้จ่ายของคําขอนี้ ได้ผลลัพธ์ 5 อย่างแล้ว นี่คือคําขอค้นหาหนึ่งข้อ
ลองแหล่งข้อมูลอื่น
แต่ละแท็บเป็นสคริปต์ที่สมบูรณ์ แทนที่ quickstart.py ด้วยตัวอย่างหนึ่งและเรียกใช้ด้วยคําสั่งจากขั้นตอน 3. แต่ละการทํางานจะส่งการร้องขอใหม่หนึ่งตัว; กุญแจต้องการสิทธิ์ในการแสดงแหล่งข้อมูล
ต้องการ google_news พิมพ์ชื่อบทความและที่อยู่เชื่อมโยงจากบทความ results[].news[].
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"))ต้องการ youtube_metadata พิมพ์ชื่อวิดีโอ, ช่องและระยะเวลาในวินาที แทนที่วิดีโอ ID ที่ต้องการจะตรวจสอบ
import os
from flashdata import FlashData
with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
response = client.youtube.metadata("dQw4w9WgXcQ", include_formats=False)
if response["status"] != "done":
raise RuntimeError(response)
for video in response["results"]:
print(video.get("title"), video.get("channel"))
print("Seconds:", video.get("duration"))ต้องการ youtube_transcript พิมพ์สําเนาภาษาอังกฤษแบบอัตโนมัติที่มีอยู่แล้วจาก results[].fullText. วีดีโอต้องมีแทร็กเสียงนั้น การเรียกนี้ไม่ได้สร้างหรือแปลคําบรรยาย
import os
from flashdata import FlashData
with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
response = client.youtube.transcript("dQw4w9WgXcQ", language="en", auto=True)
if response["status"] != "done":
raise RuntimeError(response)
for track in response["results"]:
print(track.get("fullText", ""))อะไรกันนี่ 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 ()) ใช้โปรแกรมลูกข่ายภายในวงจรเหตุการณ์นั้นอีกครั้ง
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(ข้อความหลัก) สําหรับสคริปต์แบบยืนยง