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

เอกสารอ้างอิง API

Google Videos API

รับคีย์ API

หาวิดีโอในเว็บไซต์ต่างๆ กับ Google วีดีโอ เรียกดูชื่อเพลง, ลิงก์วิดีโอ, ภาพตัวอย่าง, ช่วงเวลา และข้อมูลแหล่ง

สร้างคำขอ

พารามิเตอร์ขั้นสูง

เริ่มต้นที่ 1 แต่ละหน้าเป็นคําขอแยก

Google ตัวกรองเวลา เช่น Qdr: d สําหรับวันที่ผ่านมา

POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_videos",
    "query": "me at the zoo",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
ผลในการตอบสนอง HTTPX-API-Key ยืนยัน

พารามิเตอร์

ส่ง source ถึง query ที่ระดับบนสุด ตัวเลือกของแหล่งอยู่ใน params. ช่องข้อมูลทางเลือกสามารถยกเลิกได้

เนื้อหาคำขอ

sourcestring / จำเป็น
กําหนดเป็น google_videos
querystring / จำเป็น
สืบค้น การรองรับ Google ผู้ดําเนินการการค้นหาเช่นเว็บไซต์: และเนื้อหา:
1 ถึง 2,000 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
paramsobject / ไม่บังคับ
Settings สําหรับการร้องขอนี้
ค่าปริยาย: {}
callback_urlstring · nullable / ไม่บังคับ
Async และชุดเท่านั้น สาธารณะ HTTPS เสร็จสมบูรณ์แล้ว URL บนพอร์ต 443ถึง 2,048 ตัวละคร ไม่มีเอกสารรับรองผู้ใช้หรือส่วน URL Omit, ใช้ null หรือข้อความเปล่าสําหรับไม่ให้แจ้งเตือน ในชุดนี้ กําหนดให้แต่ละคําถาม ภายนอกพม่า
ค่าปริยาย: ยังไม่ได้ตั้งค่า

ประเทศ, ตําแหน่งภาษา

params.glstring / ไม่บังคับ
รหัสประจําประเทศ 2 ตัว เช่นเรา จีบี หรือ เอสจี ตั้งค่าโดยตรงเพื่อเลือกประเทศ
ตรงกับ 2 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
รูปแบบที่ยอมรับได้^[A-Za-z]{2}$
params.hlstring / ไม่บังคับ
Google ภาษาอินเตอร์เฟส ตั้งค่าโดยตรงเพื่อเลือกภาษา
1 ถึง 35 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
รูปแบบที่ยอมรับได้^[A-Za-z0-9-]+$
params.locationstring / ไม่บังคับ
ร้องขอสถานที่ค้นหา โดยเฉพาะอย่างยิ่งเป็นเมือง เช่น "London, England, United Kingdom" ความสามารถขึ้นอยู่กับชนิดของการค้นหา
1 ถึง 200 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า

การวางพาเนล

params.numinteger / ไม่บังคับ
ร้องขอผลนับ FlashData ไม่ได้ทําการเพิ่มค่าค่าปริยายที่คงที่เมื่อลบทิ้ง จํานวน ที่ กลับ มา อาจ ต่าง กัน ได้ โดย การ สอบ ถาม และ ชนิด การ ค้นคว้า.
1 ถึง 100, จํานวนเต็มค่าปริยาย: ยังไม่ได้ตั้งค่า
params.pageinteger / ไม่บังคับ
หน้าผลการขอ ตั้งให้ตรง. แต่ละหน้าเป็นการร้องขอแยก API
1 ถึง 100, จํานวนเต็มค่าปริยาย: ยังไม่ได้ตั้งค่า

ตัวกรองการค้นหา

params.tbsstring / ไม่บังคับ
ต้องการ Google ตัวกรองสําหรับค้นหา เช่น Qdr: d สําหรับวันที่ผ่านมา หรือ qdr: w สําหรับสัปดาห์ที่ผ่านมา ความสามารถขึ้นอยู่กับชนิดของการค้นหา
1 ถึง 200 ตัวอักษรค่าปริยาย: ยังไม่ได้ตั้งค่า
params.autocorrectboolean / ไม่บังคับ
ต้องการแก้ไขคําสะกดด้วย true หรือร้องขอให้ปิดการทํางาน false. พฤติกรรมประยุกต์ขึ้นอยู่กับชนิดของการค้นหา; การแทนที่ที่จะใช้ Googleพฤติกรรม
true หรือ falseค่าปริยาย: ยังไม่ได้ตั้งค่า

คำตอบ

Realtime กลับค่า status: done ด้วยการแสดงผลการค้นหาใน results[0]. ตรงกันใน results[0].videos. usage.credits บันทึกค่าใช้จ่าย.

ผล ที่ ตาม มา คือ วี ดิ ทัศน์ และ สิ่ง ที่ เชื่อม โยง กับ หน้า ต่าง ๆ; ไม่ มี สื่อ ที่ ดาวน์ โหลด ได้. ช่วงเวลาตัวเลือก, การแจ้งวันที่และช่องเสียงจะถูกคืนตามที่กําหนดโดย Google

อ่านผลที่ออกมา

บันทึกความสําเร็จ JSON ตอบกลับเป็น response.json. บันทึกนี้เป็น read-response.py และเรียกไพธอน read-response.py. มันใช้เฉพาะ Pythonห้องสมุดมาตรฐาน และไม่มีการร้องขอใหม่

read-response.py
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {"title": item.get("title"), "url": item.get("link"), "duration": item.get("duration")}
    for item in result.get("videos", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))

ช่องข้อมูลที่มีอยู่จะขึ้นอยู่กับการค้นหาและชนิดการค้นหา อาจ ไม่ มี ทุ่ง นา แห่ง อื่น และ อาจ ได้ รับ การ กลับ มา อีก.

จํานวนรายการที่ส่งคืนและ searchParameters.num แตกต่างจาก params.num. ใช้อาร์เรย์ที่ส่งกลับเพื่อตรวจจํานวนผลลัพธ์ที่มีผลจริง

ช่องข้อมูลทั้งหมด
ช่องข้อมูลคําอธิบาย
sourcestringสิ่งที่ร้องขอมา API แหล่งข่าว
statusstringเสร็จสิ้นเมื่อการร้องขอจริง สําเร็จ
created_atstringช่วงเวลาการสร้างแบบ ISO 8601
usage.creditsnumberบัตรเครดิตตามที่ขอ จากแผนของคุณ
results[0].searchParametersobjectตั้งค่าการค้นหาโดย Google โดยมีการสืบค้นเป็น Q การตั้งค่าที่ส่งกลับอาจจะแตกต่างจากค่าที่ต้องการ
results[0].videosarrayผลการค้นหาวิดีโอจาก Google
results[0].videos[].titlestringชื่อวิดีโอ
results[0].videos[].linkstringวีดิทัศน์หน้า URL.
results[0].videos[].snippetstring · optionalภาพตัดต่อวิดีโอ
results[0].videos[].durationstring · optionalฟอร์แมตระยะเวลาวิดีโอ
results[0].videos[].sourcestring · optionalโฮสต์เวปไซต์
results[0].videos[].channelstring · optionalสํานักพิมพ์หรือชื่อทางช่อง
results[0].videos[].datestring · optionalวันสาธารณะที่แสดงโดย Google
results[0].videos[].imageUrlstring · optionalVideo URL.
results[0].videos[].positionintegerตําแหน่งที่มีผล
results[0].videos[].videoUrlstring · optionalวิดีโอ URL รายงานโดย Google เมื่อมีให้ใช้

ช่องข้อมูลด้านบน จะใช้อธิบายค่าปริยาย JSON ตอบสนอง JSONข้อความธรรมดาและ Markdown รูปแบบ.

Async วงจรชีวิตแบบชุด

การรับช่วงนําใบเสร็จกลับมา ไม่ใช่ผลลัพธ์ Async สร้างงานหนึ่งงาน; กลุ่มต่าง ๆ จะคืนค่ากลับมาเป็นงานที่แยกไว้ queries[] สําหรับทุก ๆ คนที่สอบถามเจ้า ติดตามและรับงานแต่ละงานเป็นอิสระ

ส่งข้อมูลไปยัง data.flashdata.dev; สืบค้นสถานะงานและผลลัพธ์จาก api.flashdata.dev กับ X-API-Key แบบเดียวกัน ความ เกี่ยว พัน API ตัวอย่างพื้นฐานที่ใช้ Python ถึง cURL.

  1. 1. บันทึกงาน IDs

    เก็บรายการที่ต้องการของแหล่งนี้เมื่อสลับไปยัง Async สําหรับ Batchใส่การร้องขอแต่ละในลําดับของ JSON วัตถุ บันทึกงานที่ส่งกลับทั้งหมด ID

    Async ร้องขอและใบเสร็จ · Batch ต้องการตัวบุคคล

  2. 2. ตรวจสอบสถานะ

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: โพลด้วยความล่าช้าและความเคารพ Retry-After เมื่อถึงวันนี้ completed: รับผล failed: สืบค้นเมื่อ job.error.

    อ่าน job.status ไม่ใช่สถานะใบเสร็จรับส่ง

    ตรวจสอบสถานะที่: Python ถึง cURL

    สถานะงาน API อ้างอิง
  3. 3. ดึงข้อมูลผลลัพธ์

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    หลังจากเติมให้สมบูรณ์แล้ว ให้ยืนยันการอ่านผลที่อ่านแล้ว 302 คลังสื่อ URL # หากไม่มีเธอ # API กุญแจ บันทึก JSON ภายใน 24 ชั่วโมงของการเติมให้สมบูรณ์

    ดึงข้อมูลผลลัพธ์ที่ออกมา Python ถึง cURL · รูปแบบคำตอบ

    ดาวน์โหลดผลลัพธ์ API อ้างอิง

การ สํารวจ และ ได้ ผล ที่ มี อยู่ แล้ว ไม่ ได้ ใช้ เงิน เครดิต ที่ สอบ ถาม. จับเวลาแบบสํารวจไม่ได้ยกเลิกงาน: ให้ ID แทนการส่งงานที่ซ้ํากัน % 1 ไม่ถูกต้อง!.

Webhook เมื่อเสร็จสิ้น

บอกรับต่อคําค้น

ตั้งค่า callback_url ที่ระดับบนสุดของการร้องขอ Asinc หรือ ภายในแต่ละคําถาม ในชุดที่อยู่นอก params. ไม่มีความต้องการการแยกเว็บฮุค- regressing Realtime ร้องขอไม่ให้ส่งการเรียกกลับ

ใช้สาธารณะชน HTTPS URL บนพอร์ต 443. FlashDataPOSTS แจ้งเตือนสําหรับแต่ละงานพิมพ์ที่ไปถึง completed หรือ failed; เหตุการณ์ที่บรรจุลิงก์ ไม่ใช่ผลลัพธ์เอง

การยอมรับและตรวจสอบ

กลับค่า 2xx หลังจากยอมรับเหตุการณ์นั้น บิดเบี้ยวโดย delivery_id, ยังถูกส่งมาเป็น X-Delivery-Id. ไม่ ปฏิบัติ ตาม การ ชี้ นํา.

การส่งล้มเหลว การลองใหม่ด้วยการกลับแบบเอกซ์โปเนนเชียลขึ้นไป 8 พยายามรวมทั้งหมด และที่มากที่สุด 24 ชั่วโมงหลังจากเติมให้สมบูรณ์แล้ว. ให้การวินิจฉัยเป็น การผิดพลาด

การเรียกตัวยังไม่แน่ชัด ยืนยันงาน IDแหล่งที่มาและสถานะปลายทางผ่าน สถานะที่ยืนยันแล้ว ก่อนที่จะประมวลผลการแจ้งเตือน การส่งมอบ ID สําหรับ deduction, ไม่ใช่ข้อพิสูจน์ของความเป็นจริง

ตัวอย่าง Hook เหตุการณ์และช่องข้อมูล
แจ้งเตือนการเติมให้สมบูรณ์
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "google_videos",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
      "method": "GET"
    }
  ]
}
ช่องข้อมูลคําอธิบาย
delivery_idstringเครื่องระบุการจัดส่งที่ทนทาน การแจ้งให้ทราบแบบย่อโดยใช้ค่านี้; มันถูกส่งมาใน X-Delivery-Id ส่วนหัว
idstringJoob ID.
sourcestringต้องการแหล่งข้อมูล
statusstringเสร็จสมบูรณ์หรือล้มเหลว
linksarrayสถานะและการเชื่อมโยงผลลัพธ์ การแจ้งให้ทราบไม่รวมเนื้อหาหรือรายการที่มีผล API กุญแจ
links[].relstringตัวตนหรือผลลัพธ์
links[].hrefstringการจัดการสัมบูรณ์ API URL2; ยืนยันตัวด้วย API กุญแจ
links[].methodstringGET.

สัญญาเว็บฮุคแบบเต็มและ URL จํากัด

การกู้คืนผิดพลาด

การค้นหาเสร็จสมบูรณ์ อาจมีตัวที่เข้าเงื่อนไขน้อยกว่าที่ต้องการ ตรวจสอบ gl, hl, สถานที่ที่และกรอง; เลือกพื้นที่อุดมไปด้วยอาจจะขาด

สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอunit-format และอัตราการสิ้นสุดของอัตรา - การอ้างอิงข้อผิดพลาดร่วมกัน เวลา ที่ ใช้ ไป แล้ว อาจ ยัง คง สร้าง งาน อยู่; ตรวจ สอบ งาน ที่ มี อยู่ ก่อน จะ ลอง ทํา ใหม่.

ข้อผิดพลาดและรหัสสถานะ · เมื่อต้องการลองใหม่ · ข้อจํากัดของอัตรา

ไกด์ทีละขั้น: เลือกและ ขัดมัน Google ค้นหา

ราคา

แผนอัตราการใช้ต่อ 1,000 คำขอสมาชิกรวมการให้เครดิตต่อช่วงเวลาเรียกเก็บเงิน
จ่ายตามการใช้งานUS$1.00ไม่มีค่าบริการรายเดือนเติมเครดิตเมื่อจำเป็น
MicroUS$0.80US$49.00 / เดือน1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม
StarterUS$0.65US$199.00 / เดือน4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม
ProUS$0.60US$499.00 / เดือน10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม
ScaleUS$0.50US$999.00 / เดือน20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม
BusinessUS$0.40US$1,999.00 / เดือน40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม

หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ

ราคาและแผนจํากัดในปัจจุบัน