YouTube API

​

Đăng bài lên YouTube

​

Tổng quan về đăng bài

{
  // Required: Video description
  "post": "My Best YouTube Description", // empty string is allowed

  // Required: Platform to post to
  "platforms": ["youtube"],

  // Required: URL of video (only 1 allowed)
  "mediaUrls": ["https://img.ayrshare.com/012/vid.mp4"],

  "youTubeOptions": {
    // Required: Video title (max 100 characters)
    "title": "Your Best Title"
  }
}

​

Các trường tùy chọn của bài đăng YouTube

{
  // Required fields
  "post": "My Best YouTube Description", // Video description, up to 5,000 characters
  "platforms": ["youtube"], // Platform to post to
  "mediaUrls": ["https://img.ayrshare.com/012/vid.mp4"], // URL of video (1 allowed)

  "youTubeOptions": {
    // Required fields
    "title": "Your Best Title", // Video Title (max 100 characters)

    /** Optional Fields **/

    // Visibility: "public", "unlisted", or "private" (default: "private")
    "visibility": "private",

    // Thumbnail settings - JPEG/PNG URL under 2MB, must end in png/jpg/jpeg
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg",

    // Video organization
    "playListId": "PLrav6EfwgDX5", // Playlist ID to add the video
    "tags": ["dancing", "dogs"], // Tag array (400 chars total, 2+ chars each)

    // Video settings
    "madeForKids": false, // Self-declared kids content (default: false)
    "license": "youtube", // "youtube" (default) or "creativeCommon"
    "embeddable": true, // default: true
    "publicStatsViewable": true, // default: true
    "shorts": true, // Post as YouTube Short (max 3 minutes, adds #shorts)
    "notifySubscribers": true, // Send notification to subscribers (default: true)
    "categoryId": 24, // Video category (24 = Entertainment)
    "containsSyntheticMedia": true, // Disclose that a video contains realistic Altered or Synthetic (A/S) content

    // YouTube controlled publishing - UTC publish time. See below for details.
    "publishAt": "2022-10-08T21:18:36Z",
  }
}

• title phải có 100 ký tự trở xuống. post phải có 5.000 ký tự trở xuống. post và title có thể chứa bất kỳ ký tự nào ngoại trừ < và >.
• Playlist Id có thể được tìm thấy bằng cách mở playlist trong trình duyệt và sao chép giá trị sau list=. Người dùng và channel đã xác thực phải là chủ sở hữu của playlist để thêm video.
• Nếu video của bạn không kết thúc bằng phần mở rộng video đã biết như mp4, vui lòng sử dụng tham số isVideo. Xem endpoint /post để biết chi tiết.
• Trường publishAt sẽ cho phép YouTube kiểm soát thời gian xuất bản. Video sẽ là private cho đến thời gian xuất bản khi nó sẽ được công khai. Nếu thời gian xuất bản ở trong quá khứ, video sẽ được công khai ngay lập tức. Không sử dụng trường scheduleDate của bài đăng khi sử dụng trường publishAt.
• Trường containsSyntheticMedia được sử dụng để tiết lộ rằng một video chứa nội dung thực tế Altered hoặc Synthetic (A/S): Làm cho một người thật xuất hiện nói hoặc làm điều gì đó mà họ không thực sự nói hoặc làm, thay đổi cảnh quay của một sự kiện hoặc địa điểm thực, tạo ra một cảnh trông thực tế mà thực sự không xảy ra.
• license - Đặt loại giấy phép video. Các giá trị được chấp nhận: "youtube" (Standard YouTube License, mặc định) hoặc "creativeCommon" (Creative Commons - Attribution).
• embeddable - Boolean (hoặc các chuỗi "true" / "false"). Kiểm soát liệu video có thể được nhúng trên các trang web bên thứ ba hay không. Mặc định: true.
• publicStatsViewable - Boolean (hoặc các chuỗi "true" / "false"). Kiểm soát liệu bảng thống kê mở rộng trên trang xem của video có thể xem công khai hay không. Số lượt xem cơ bản và số lượt thích vẫn hiển thị công khai bất kể cài đặt này. Mặc định: true. Xem status.publicStatsViewable trong tham chiếu YouTube Data API để biết chi tiết.
• Xem YouTube Media Guidelines để biết thêm thông tin.

​

YouTube Shorts

​

Đăng YouTube Shorts

{
  "youTubeOptions": {
    "shorts": true
  }
}

​

Thông tin quan trọng về YouTube Shorts

• Gửi một video dưới dạng Short là dấu hiệu cho YouTube biết bạn muốn video xuất hiện dưới dạng Short, nhưng không đảm bảo nó sẽ xuất hiện dưới dạng Short. Video phải đáp ứng các yêu cầu Short video, chẳng hạn như dài 3 phút trở xuống và tỷ lệ khung hình dọc 9:16 để được YouTube coi là Short.
• YouTube Shorts không hỗ trợ thumbnails.
• Thông tin bổ sung về việc sử dụng API để đăng YouTube Shorts.

​

Thumbnails YouTube

​

Thêm YouTube Thumbnails

{
  "youTubeOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}

​

Bật Thumbnails trong YouTube Studio

​

Video: Đăng bài lên YouTube qua API

​

Giới hạn tải lên

• Tùy thuộc vào vị trí của một creator, một channel có thể tăng giới hạn hàng ngày của họ bằng cách có được quyền truy cập vào các tính năng nâng cao. Để tìm hiểu thêm, hãy truy cập bài viết này.
• Giới hạn có thể khác nhau tùy theo quốc gia/khu vực hoặc lịch sử channel. Các vi phạm bản quyền có thể ảnh hưởng đến tính đủ điều kiện lịch sử channel và Vi phạm Nguyên tắc Cộng đồng sẽ ảnh hưởng đến số lượng channel có thể tải lên.

​

Liên kết mô tả

​

Playlists

{
  "youTubeOptions": {
    "playListId": "PLrav6EfwgDX5"
  }
}

​

Phụ đề / Caption cho video

{
  "youTubeOptions": {
    "title": "My new post from Ayrshare to Youtube",
    "subTitleUrl": "https://img.ayrshare.com/012/captions.srt",
    "subTitleLanguage": "en",
    "subTitleName": "English"
  }
}

• subTitleUrl: Một file SRT hoặc SBV hợp lệ. URL phải bắt đầu bằng https:// và kết thúc bằng .srt hoặc .sbv và là một file SRT hoặc SBV hợp lệ. File phải dưới 100 MB.
• subTitleLanguage: Tùy chọn: Ngôn ngữ của phụ đề. Phải là một mã ngôn ngữ hợp lệ. Mặc định: “en”.
• subTitleName: Tùy chọn: Tên của track caption. Tên nhằm hiển thị cho người dùng dưới dạng tùy chọn trong quá trình phát lại. Độ dài tên tối đa được hỗ trợ là 150 ký tự. Mặc định: “English”.

## SRT Format Example
1
00:00:01,000 --> 00:00:04,000
Welcome to our tutorial on subtitle formats.

2
00:00:04,500 --> 00:00:08,000
Today we'll learn about SRT and SBV files.

## SBV Format Example
0:00:01.000,0:00:04.000
Welcome to our tutorial on subtitle formats.

0:00:04.500,0:00:08.000
Today we'll learn about SRT and SBV files.

​

Tags

{
  "youTubeOptions": {
    "tags": ["dancing", "dogs"]
  }
}

​

Nhắc tên (Mention) trên YouTube

​

Giới hạn ký tự

​

Endpoint bổ sung