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

คู่มือ

เพิ่มข้อมูลให้รายการวิดีโอ YouTube

เพิ่มข้อมูลกํากับภาพไปยังรายการเล่น, กําลังอ่านรายการหรือชุดข้อมูลโปรแกรม ในขณะที่คงบันทึกเดิมของคุณไว้ IDs และทุก ๆ ผลที่ออกมา

ในหน้านี้

จากบันทึกของคุณไปยังชุดข้อมูลที่อุดมสมบูรณ์

เริ่มด้วยบันทึกสามฉบับ ที่อ้างถึงสองวิดีโอ สืบค้นแต่ละวิดีโอที่แตกต่างกัน แล้วต่อข้อมูลกลับเป็นบันทึกทั้งสามอัน การทํางานนี้ใช้การร้องขอแบบ Batch เล็ก ๆ และยังคงทําให้รายการที่ไม่สามารถทํางานได้

ช่องข้อมูลส่งออกวัตถุประสงค์
record_id · inputบันทึกต้นฉบับของคุณและสนาม ในลําดับเดิม
video_id · query_index · job_idตามรอยบันทึกแต่ละฉบับ ที่ทําขึ้น
status · metadata · result_fileผลที่เสร็จสมบูรณ์หรือโดยตรง pending/failed/read-error ผล

1. ตรวจสอบเครื่องมือและการเข้าถึงของคุณ

ใช้ FlashData CLI v1.2.1 บน PATH ถึง Node.js 22+. ทํางานในโฟลเดอร์ใหม่ โดยมีการอนุญาตจากเจ้าของของคุณอยู่แล้ว โดยมี youtube_metadata Bash ถึง PowerShell ใช้คําสั่งเดียวกันข้างล่าง

เก็บบัญชีและประวัติเดิมไว้ตลอด สําหรับโพรไฟล์ชื่อ, ตั้งค่า FLASHDATA_PROFILE ในสนามบินนี้ พวกนักสะสมจึงใช้มันด้วย เจ้าหน้าที่สามารถโหลด FLASHDATA_API_KEY จากร้านลับของพวกเขา

ตรวจสอบเครื่องมือและตรวจสอบสิทธิ์ที่ใช้งานได้ฟรี
flashdata --version
node --version
flashdata auth status --json
mkdir video-enrichment
cd video-enrichment

ตรวจสอบความสมดุลและความสามารถ

ยืนยันการเข้าถึงเจ้าของ youtube_metadata อนุญาตและห้องพักสําหรับสองรายการชุดและระหว่างงาน ถ้าการเข้าถึงชั่วคราวยังคงใช้งานอยู่ ให้ขอยืนยันหรือใช้สูตรวีดิโอแบบเดี่ยว ทบทวนการประมาณการทํางานแบบแห้งในขั้นตอน 3 ก่อนทําการส่งข้อมูล

อ่านบัญชีผู้ใช้อิสระ
flashdata account balance --json
flashdata account limits --json

2. เตรียมบันทึกการป้อนข้อมูลของคุณ

บันทึกนี้เป็น videos.json แทนที่ค่าต่าง ๆ ด้วยบันทึกของคุณเอง IDs ถึง 11- ช่างทําเล็บ YouTube วิดีโอ IDs. ช่องข้อมูลเพิ่มเติมคงอยู่ในการค้นหาภายในเครื่อง และไม่ถูกส่งไปที่ FlashData ทําซ้ําวิดีโอ IDs ได้รับอนุญาตให้ใช้ record_id ต้องพิเศษแน่ๆ

videos.json
[
  {
    "record_id": "lesson-intro",
    "video_id": "jNQXAC9IVRw",
    "collection": "Course"
  },
  {
    "record_id": "playlist-song",
    "video_id": "dQw4w9WgXcQ",
    "collection": "Playlist"
  },
  {
    "record_id": "saved-intro",
    "video_id": "jNQXAC9IVRw",
    "collection": "Reading list"
  }
]

บันทึก prepare.mjs

สร้าง prepare.mjs ข้าง videos.json ในแฟ้มวิดีโอ คัดลอกรหัสที่สมบูรณ์ด้านล่างในนั้นและบันทึกมัน

สคริปต์จะตรวจสอบทุกแถวก่อนที่จะสร้าง prepared/. มันลดความซับซ้อนของวิดีโอ IDs สําหรับการร้องขอข้อมูลกํากับภาพนี้ โดยจะคงการบันทึกและลําดับเดิมไว้

prepare.mjs
// prepare.mjs — local preparation; sends no API requests.
import { mkdir, readFile, writeFile } from 'node:fs/promises';

const rows = JSON.parse((await readFile('videos.json', 'utf8')).replace(/^\uFEFF/, ''));
if (!Array.isArray(rows) || rows.length === 0) throw new Error('Supply a nonempty array of records.');
const recordIds = new Set(), videoIndexes = new Map(), queries = [];
const mapping = rows.map((input, index) => {
  if (!input || typeof input !== 'object' || Array.isArray(input)
      || typeof input.record_id !== 'string' || !input.record_id.trim()
      || recordIds.has(input.record_id) || typeof input.video_id !== 'string'
      || !/^[A-Za-z0-9_-]{11}$/.test(input.video_id)) {
    throw new Error('Invalid or duplicate record_id, or invalid video_id at row ' + (index + 1));
  }
  recordIds.add(input.record_id);
  if (!videoIndexes.has(input.video_id)) {
    videoIndexes.set(input.video_id, queries.length);
    queries.push({ source: 'youtube_metadata', video_id: input.video_id,
      params: { include_formats: false } });
  }
  return { input, query_index: videoIndexes.get(input.video_id) };
});
// Existing preparation is kept intact. Use it to resume, or choose a new folder.
await mkdir('prepared');
await writeFile('prepared/batch.json', JSON.stringify(queries, null, 2), { flag: 'wx' });
await writeFile('prepared/input-map.json', JSON.stringify(mapping, null, 2), { flag: 'wx' });
console.log(JSON.stringify({ inputRecords: rows.length, uniqueQueries: queries.length,
  reusedVideoIds: rows.length - queries.length }, null, 2));

สร้างรายการสืบค้นภายในเครื่อง

หลังจากบันทึก prepare.mjs แล้ว ให้ดําเนินการอีกครั้ง คาด inputRecords: 3, uniqueQueries: 2 ถึง reusedVideoIds: 1. เก็บไว้ prepared/batch.json ถึง prepared/input-map.json มีการเปลี่ยนแปลงสําหรับการทํางานนี้ หากมีการเตรียม/ มีอยู่แล้ว ให้ทําการเรียกมันใหม่อีกครั้งเพื่อทําต่อ; ใช้โฟลเดอร์ใหม่สําหรับชุดข้อมูลอื่น

เตรียมการไม่เรียก API
node prepare.mjs

3. แสดงตัวอย่างและส่งวิดีโอที่ไม่ซ้ํากัน

จํานวนการเรียกดูการทํางานที่แห้งที่สุด, ค่าสถิติปัจจุบัน และค่าจํากัดของบัญชี ทบทวนมัน แล้วส่งครั้งเดียว กลุ่มตัวอย่างมีชุดที่ใส่ได้สองใบ แม้ว่าจะมีบันทึก 3 ชิ้น

เก็บไว้ submission.json และ CLI ไดเรกทอรีของรัฐ ใช้ข้อมูลเดียวกัน ID และป้อนเข้าไปหลังจากถูกขัดจังหวะ ประมวลผลใหม่ ID สร้าง งาน ใหม่; ตรวจ สอบ การ ยอม รับ ที่ ไม่ แน่นอน ก่อน ทํา การ ปรับ ปรุง ใหม่.

แสดงตัวอย่างโดยไม่ส่งข้อมูล
flashdata batch submit --input prepared/batch.json --dry-run --json
ส่งข้อมูลหลังจากอ่านค่า
flashdata batch submit --input prepared/batch.json --run-id video-metadata-001 --output submission.json --json

4. สะสมและเข้าร่วมผลลัพธ์

บันทึก collect.mjs ไว้ด้านล่าง แล้วเรียกดู นัก สะสม รอ อยู่ ถึง สอง นาที ต่อ งาน ที่ ยัง ไม่ ได้ ทํา ให้ แน่ ใจ ว่า ผล ที่ ได้ นั้น เป็น ของ วี ดิ ทัศน์ ที่ ต้องการ และ ร่วม กับ ผล แต่ ละ อย่าง กับ บันทึก เดิม. วิ่งไปทีละตัวเลย

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

บันทึก collect.mjs

สร้าง collect.mjs ในแฟ้มวิดีโอที่อุดมไปด้วยแบบเดียวกันนี้, ข้าง submission.json ถึง prepared/. คัดลอกรหัสที่สมบูรณ์ด้านล่างในนั้นและบันทึกมัน

collect.mjs
// collect.mjs — reads saved jobs; never submits another query.
import { execFileSync } from 'node:child_process';
import { mkdir, readFile, writeFile, rename } from 'node:fs/promises';

const readJSON = async file => JSON.parse((await readFile(file, 'utf8')).replace(/^\uFEFF/, ''));
const cli = (...args) => JSON.parse(execFileSync('flashdata', [
  ...args, '--json', '--non-interactive', '--timeout', '2m',
], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], maxBuffer: 16 * 1024 * 1024 }));
const inputs = await readJSON('prepared/batch.json');
const mapping = await readJSON('prepared/input-map.json');
const saved = await readJSON('submission.json');
const receipts = (saved.submission ?? saved).queries;
if (!Array.isArray(inputs) || !inputs.length || !Array.isArray(receipts)
    || receipts.length !== inputs.length || new Set(receipts.map(r => r.id)).size !== receipts.length
    || inputs.some(q => q.source !== 'youtube_metadata') || !Array.isArray(mapping) || !mapping.length
    || mapping.some(row => !Number.isInteger(row.query_index)
      || inputs[row.query_index]?.video_id !== row.input?.video_id)) {
  throw new Error('Input/receipt mismatch. Keep the original prepared files and receipt.');
}
await mkdir('results', { recursive: true });
const binding = JSON.stringify({ inputs, mapping, receipts });
try { await writeFile('results/input-receipts.json', binding, { flag: 'wx' }); }
catch (error) {
  if (error.code !== 'EEXIST') throw error;
  if (await readFile('results/input-receipts.json', 'utf8') !== binding) {
    throw new Error('Inputs or receipts changed. Restore the original files.');
  }
}
const rows = inputs.map((input, query_index) => ({ query_index,
  video_id: input.video_id, job_id: receipts[query_index].id, status: 'unread' }));
const saveRows = async (path, values) => {
  await writeFile(path + '.next', values.map(row => JSON.stringify(row)).join('\n') + '\n');
  await rename(path + '.next', path);
};
for (const row of rows) {
  try {
    if (!/^[a-zA-Z0-9_-]+$/.test(row.job_id ?? '')) throw new Error('Invalid job ID.');
    const file = 'results/' + row.job_id + '.json';
    let result;
    try { result = await readJSON(file); }
    catch (error) { if (error.code !== 'ENOENT') throw error; }
    if (!result) {
      let job;
      try { job = cli('jobs', 'wait', row.job_id).data; }
      catch { job = cli('jobs', 'get', row.job_id).data; }
      if (job.videoId !== row.video_id || job.source !== 'youtube_metadata') {
        throw new Error('Job/input mismatch. Inspect the saved input and receipt.');
      }
      row.status = job.status;
      row.error = job.error ?? null;
      if (job.status === 'completed') {
        cli('jobs', 'result', row.job_id, '--output', file);
        result = await readJSON(file);
      }
    }
    if (result) {
      if (result.status !== 'done' || result.source !== 'youtube_metadata'
          || result.results?.length !== 1 || result.results[0].videoId !== row.video_id) {
        throw new Error('Result/video mismatch. Inspect the saved JSON before continuing.');
      }
      Object.assign(row, { status: 'completed', metadata: result.results[0], error: null,
        credits: result.usage?.credits ?? null, result_file: file });
    }
  } catch (error) {
    row.status = 'read_error';
    row.error = error.stderr?.toString().trim() || error.message;
  }
  await saveRows('metadata.ndjson', rows); // One outcome and charge per unique query.
  await saveRows('enriched.ndjson', mapping.map(({ input, query_index }) => {
    const { credits, ...outcome } = rows[query_index]; // Do not duplicate a charge across input records.
    return { record_id: input.record_id, input, ...outcome };
  }));
}
const failed = rows.filter(row => ['failed', 'cancelled'].includes(row.status));
await writeFile('failed-videos.json', JSON.stringify(failed, null, 2));
console.table(rows.map(({ video_id, job_id, status }) => ({ video_id, job_id, status })));
console.log('Saved enriched.ndjson, metadata.ndjson and results/*.json.');
if (rows.some(row => row.status !== 'completed')) process.exitCode = 1;

ประมวลผลหรือเรียกเก็บต่อ

เรียกใช้จากวิดีโอ-entriment หลังจากบันทึก collect.mjs เก็บต้นฉบับไว้ CLI โพรไฟล์และไดเรกทอรีของรัฐ

สะสมหรือทําต่อ
node collect.mjs

แฟ้มที่ต้องการ

แฟ้มใช้มันเพื่อ
enriched.ndjsonหนึ่งแถวต่อแผ่นต้นฉบับ รวมทั้งซ้ําและล้มเหลว นําเข้าโดย record_id
metadata.ndjsonหนึ่งแถวต่อคําค้นที่ไม่ซ้ํากัน, มีงาน IDไฟล์ผลและเครดิตที่แท้จริง ครั้งนึงมีการนับ
results/*.jsonการตอบรับแบบ Raw สําเร็จแล้ว บวกการบันทึก input/receipt ผูกพัน
failed-videos.jsonยืนยัน failed/cancelled งานสําหรับทบทวน งานที่ต้องใช้ความพยายามในการอ่าน และแก้ไขไม่ได้ ถูกกันออกจากรายการนี้

5. ใช้ บันทึก ที่ เพิ่ม พูน ขึ้น ใน โปรแกรม ของ คุณ

บันทึก inspect.mjs ในวิดีโอ-โครงสร้าง, ด้านข้าง enriched.ndjsonประมวลผลมันจากโฟลเดอร์นั้น คาดว่าจะมีบันทึกต้นฉบับ 3 ชิ้น และชุดพิเศษ 2 ชุด อยู่เหนือแถวที่เสร็จ record_idเก็บบันทึกข้อมูลของคุณไว้ และเก็บแถวที่ยังไม่สมบูรณ์ ไว้ในรายงานการนําเข้า อ่านชื่อเรื่องและระยะเวลาจากข้อมูลกํากับภาพ; ใช้ video_id สําหรับที่อยู่เชื่อมโยงหรือการร้องขอคําบรรยายในภายหลัง

inspect.mjs
// inspect.mjs — inspect your dataset without another API call.
import { readFile } from 'node:fs/promises';
const rows = (await readFile('enriched.ndjson', 'utf8')).trim().split('\n').map(JSON.parse);
console.table(rows.map(row => ({ record_id: row.record_id, video_id: row.video_id,
  collection: row.input.collection, status: row.status, title: row.metadata?.title ?? null })));
console.log('Original records:', rows.length);
console.log('Unique queries:', new Set(rows.map(row => row.query_index)).size);
แสดงเฉพาะบันทึกที่ผนวกรวม
node inspect.mjs

ทําต่อไปจากรายการที่ต้องการความสนใจ

บันทึกผลลัพธ์ภายในของพวกเขา 24- ระยะเวลาพักหลัง สําหรับเรียกปรับปรุงอีกครั้ง ให้ใช้โฟลเดอร์จับภาพตัวใหม่ แล้วทํางาน ID เฉพาะเมื่อคุณตั้งใจที่จะจ่ายสําหรับข้อมูลใหม่เก็บไว้ record_id มั่นคงในใบสมัครของคุณ.

ข้อมูลออกการกระทําถัดไป
pending / processingดําเนินการสะสมอีกครั้งภายหลัง ให้งานเดิม IDs
failed / cancelledทบทวน failed-videos.json และความผิดพลาดของงาน แก้ไขสาเหตุก่อนที่จะจงใจขอวิดีโอนั้นอีกครั้ง
read_errorแก้ไขการเข้าถึง, การเชื่อมเข้าหรือผลลัพธ์การบันทึก เก็บแฟ้มดิบเพื่อตรวจสอบ; ข้อผิดพลาดในการอ่าน ไม่ได้หมายความว่าต้องการการค้นหาใหม่
ไม่มีข้อมูลผลลัพธ์การรับข้อมูลตรวจหาการประมวลผลภายในและ History ก่อนที่จะยอมจํานนอีกครั้ง
แสดงเฉพาะกลุ่มที่บันทึกไว้
flashdata runs show video-metadata-001 --json