Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Hướng dẫn

YouTube Download Thực hành tốt nhất

Chọn đầu ra đúng phương tiện, điều khiển những gì bạn tải về, và biến một công việc hoàn tất thành một tập tin tư nhân có thể sử dụng.

Trên trang này

Hãy bắt đầu với những gì bạn cần

Mục tiêu của bạnDùng
Tóm tắt nội dung đã nói hoặc xây dựng chỉ mục văn bảnTrước tiên, hãy đọc một bản sao đã có. Chỉ tải về âm thanh khi bạn cần âm thanh, như bước nói chuyện để văn bản.
Tiến trình phát âm hoặc âm thanhĐầu ra chỉ âm thanh. Tránh mang theo video theo dõi ứng dụng của bạn không dùng.
Hiển thị đoạn ngắnĐặt start_at và end_at. Kiểm tra rằng cả hai đều nằm trong khoảng thời gian của video nguồn.
Chơi hay xử lý videoMP4 với âm thanh và một nắp giải quyết phù hợp với ứng dụng của bạn; ví dụ này dùng <=720.

Lưu kết xuất mà bạn muốn

Chọn một tab và lưu toàn bộ yêu cầu của nó như là download-request.json. Thay đổi video_id cho nguồn của bạn. Lệnh phục tùng bên dưới đọc tập tin này, vì vậy chọn âm thanh hay clip thay đổi yêu cầu thực sự.

Một đoạn video đầy đủ với âm thanh, bị bao phủ tại 720p.

download-request.json
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "output_format": "mp4",
    "video_quality": "<=720"
  }
}

Kiểm tra quyền truy cập và giá trị phụ thuộcte

Dùng Bash và jq, cộng với tiết kiệm CLI hồ sơ hay FLASHDATA_API_KEY Vì HTTP. Chìa khóa cần thiết youtube_download Cho phép. Tải về cần thiết quyền người sở hữu; quyền truy cập thử nghiệm tạm thời không bao gồm nó. CLI Ví dụ dùng hồ sơ mặc định; thêm --profile NAME tới mọi lệnh nếu tên của anh được đặt.

Quyết địnhÁp dụng theo cách này
Giá dự đoánDùng cái này đi creditsPerTb và bytesPerUnit với các byte ước tính đầu ra của bạn. Việc tải về không phải là một tính phí cố định cho mỗi yêu cầu.
Phạm vi điều khiểnChọn âm thanh, clip hoặc nắp giải quyết trước khi nộp. Áp dụng số liệu công việc và chi tiêu các quy tắc trong đơn xin việc của bạn.
Ghi lại chi phí thực sựĐọc từ lần giao xong. Việc nhập viện có thể giữ được tín dụng trước khi việc tải lên được giải quyết; sự số dư hiện tại không phải là một cái nắp chi tiêu cho một công việc.
Kiểm tra miễn phí # CLI
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json

Dùng điểm đến riêng cho mỗi kết xuất

Lưu storage.json Riêng tư với giá trị đích thực của bạn. Giữ nó bên ngoài kiểm soát nguồn. Sử dụng một khác biệt object_prefix cho mỗi video/output Phiên bản; tái sử dụng một tiền tố cho các kết quả khác nhau làm cho hồ sơ ứng dụng khó hòa giải hơn.

Nhận diệnMục đích
Phím FlashDataGửi tải xuống và đọc công việc và giao hàng của nó JSON.
NameViết truyền thông tới xô và tiền tố đã định.
Nhận diện kho lưu ứng dụngĐọc mục riêng hoặc quyền truy cập vào người dùng có thẩm quyền.
storage.json · S3
{
  "storage_type": "s3",
  "storage_url": "YOUR_BUCKET",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "us-east-1",
  "object_prefix": "media/video-001/mp4-720p-v1"
}
Linux / macOS Tập tin · cá nhân
chmod 600 storage.json

Gửi yêu cầu cứu hộ một lần

Chạy một tab sau khi lưu cả hai tập tin. Name storage.json đi qua stdin và lưu download-submission.json. Giữ cái hóa đơn này. Với CLIGiữ nguyên vị trí đó ID Cho một lần thử lại; sử dụng một điều mới ID Chỉ cho đầu ra có chủ đích mới. HTTP Phục tùng không dùng CLINhật ký điều hành địa phương.

Gởi kết xuất đã chọn
(
set -eu
umask 077
test ! -e download-submission.json || { echo 'Inspect the saved submission first.' >&2; exit 1; }
PAYLOAD=$(jq -en --slurpfile request download-request.json --slurpfile storage storage.json '
  if ($request | length) != 1 or ($storage | length) != 1
      or ($storage[0] | type) != "object" or $request[0].source != "youtube_download"
  then error("Check download-request.json and storage.json")
  else $request[0] | .params.storage = $storage[0] end')
printf '%s' "$PAYLOAD" | flashdata query --input - --mode async \
  --run-id download-001 --output download-submission.json
)

Kiểm tra trước với CLI

Mong đợi ok: true và data.dryRun: true. Kiểm tra đầu vào và FlashData Việc truy cập mà không gửi một việc làm; nó không chứng minh giấy ủy nhiệm tải lên có thể viết cho xô của bạn.

Chạy tự do
(
set -eu
PAYLOAD=$(jq -en --slurpfile request download-request.json --slurpfile storage storage.json '
  if ($request | length) != 1 or ($storage | length) != 1
      or ($storage[0] | type) != "object" or $request[0].source != "youtube_download"
  then error("Check download-request.json and storage.json")
  else $request[0] | .params.storage = $storage[0] end')
printf '%s' "$PAYLOAD" | flashdata query --input - --mode async --dry-run --json
)

Đợi công việc đã có

Hóa đơn không phải là hồ sơ truyền thông. CLI chờ đợi; các HTTP lệnh đọc tình trạng một lần. Lặp lại đoạn đọc trong thời hạn cuối cùng cho đến khi hoàn tất hoặc bị lỗi. Thời hạn cục bộ không hủy bỏ công việc máy phục vụ.

Chờ công việc đã được cứu
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)

Đọc hồ sơ giao hàng, rồi truy cập vào các phương tiện truyền thông

Sau khi hoàn thành, lấy lại delivery.json bằng cùng một con đường mà anh đã từng phục vụ. Kết quả đã được ký. URL lấy JSON; results[0].file_url Xác định phương tiện truyền thông trong kho của anh. Riêng tư file_url Cần phải có giấy tờ đọc hoặc liên kết được đưa ra bởi đơn xin việc của bạn.

Lưu delivery.json
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs result "$JOB_ID" --output delivery.json
jq '.results[0] | {file_url, file_size, md5, downloaded_bytes}' delivery.json
)

Kiểm tra xem cái gì đã được chuyển đến

Mong đợi một vị trí tập tin, một kết quả dương file_size, a MD5 và sử dụng. Thu file_size cho đối tượng được giao; downloaded_bytes là một trường chuyển giao, không phải một sự thay thế cho lần nạp cuối cùng.

Xem xét delivery.json
(
set -eu
jq -e '.source == "youtube_download" and .status == "done"
  and (.results | length == 1) and (.results[0].file_size > 0)
  and (.results[0].md5 | test("^[a-fA-F0-9]{32}$"))' delivery.json >/dev/null
jq '{file: (.results[0] | {file_url, file_size, md5, duration, output_format}), usage}' delivery.json
)

Kiểm tra bản sao của địa phương S3

Đặt OBJECT_KEY đến các phím truyền thông được chuyển từ file_urlKể cả tiền tố. Dùng AWS CLI Với quyền truy cập đọc, jq và OpenSSL. Cái này để dành. media.mp4 hay media.mp3 Tùy theo yêu cầu đã chọn, kiểm tra kích cỡ và tổng kiểm tra mà không viết quá một tập tin cục bộ đã có.

S3 đọc và không có gì mới FlashData truy vấn
(
set -eu
# Requires AWS CLI configured for read access, jq and OpenSSL.
# Set OBJECT_KEY to the delivered media object's key from file_url.
: "${OBJECT_KEY:?Set the delivered S3 object key}"
BUCKET=$(jq -er '.storage_url' storage.json)
REGION=$(jq -er '.region' storage.json)
FORMAT=$(jq -er '.params.output_format' download-request.json)
case "$FORMAT" in mp4|mp3) ;; *) echo 'Choose a filename for this format.' >&2; exit 1 ;; esac
LOCAL_FILE="media.$FORMAT"
test ! -e "$LOCAL_FILE" || { echo 'Keep the existing local file.' >&2; exit 1; }
EXPECTED_BYTES=$(jq -er '.results[0].file_size' delivery.json)
EXPECTED_MD5=$(jq -er '.results[0].md5 | ascii_downcase' delivery.json)
aws s3 cp "s3://$BUCKET/$OBJECT_KEY" "$LOCAL_FILE" --region "$REGION" --only-show-errors
ACTUAL_BYTES=$(wc -c < "$LOCAL_FILE" | tr -d '[:space:]')
ACTUAL_MD5=$(openssl dgst -md5 "$LOCAL_FILE" | awk '{print $NF}')
test "$ACTUAL_BYTES" = "$EXPECTED_BYTES"
test "$ACTUAL_MD5" = "$EXPECTED_MD5"
echo 'Delivery verified'
)

Phục hồi từ giai đoạn thất bại

Chuyện gì đã xảy raHành động tiếp theo
Không xác nhận được việc làm IDKiểm tra người được cứu CLI Chạy hoặc yêu cầu lịch sử. Giữ đầu vào ban đầu và không tự động đệ lại.
Gióp chấp nhận; chờ đợi hết giờĐọc hoặc phục hồi cùng một công việc. Không tạo một bản tải về mới để tiếp tục chờ.
Tải lên thất bạiĐọc lỗi công việc và sửa thiết lập đích hoặc ghi truy cập trước khi cố ý thử lại.
Đọc phương tiện đã trả lời 403Kiểm tra xem quyền hạn đọc hay liên kết đã đóng sẵn của ứng dụng. Hạt FlashData API Phím không mở khóa S3.
Đã ký kết quả JSON hết hạnHãy đọc lại kết quả của công việc trong khi vẫn còn. Truyền thông lưu trữ đi theo xe đạp cứu hộ của bạn.
CLI* kiểm tra các lưu chạy
flashdata runs show download-001 --json

Cung cấp cho đại lý của bạn các tiêu chuẩn đầu ra và giao hàng

Nhiệm vụ tác nhân # cung cấp video, đích và ngân sách
Sử dụng quyền truy cập của tôi và cấu hình kho lưu trữ tư nhân.
Đọc download-request.json cho video và đầu ra; không thay đổi chúng một cách âm thầm.
Kiểm tra giá trị sử dụng và tín dụng có từ ngân sách tác vụ được chấp nhận.
Phục tùng một lần, cứu lấy run/job IDRồi đọc xong công việc đó.
Để dành hồ sơ giao hàng đi. Kiểm tra kích cỡ của đối tượng đã lưu và MD5 Trước khi xử lý nó.
Báo cáo vị trí đối tượng, định dạng, kết quả thẩm tra và sử dụng thực tế.
Nếu sự phục tùng không chắc chắn, thanh tra lưu công việc, đừng tạo cơ hội tiếp cận thay thế hoặc tải về khác.
Giữ hồ sơ lưu trữ kín. Chia sẻ phương tiện chỉ qua điều khiển truy cập đã cấu hình của ứng dụng.