> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hình thu nhỏ YouTube không được áp dụng (Kênh chưa xác minh)

> Video YouTube của bạn đăng thành công nhưng hình thu nhỏ tùy chỉnh bị thiếu. Nguyên nhân phổ biến nhất là kênh YouTube chưa được xác minh.

Khi bạn đăng một video YouTube với `thumbNail` tùy chỉnh, video có thể được đăng thành công trong khi hình thu nhỏ không được áp dụng. Trong trường hợp này, `status` cấp cao nhất của bài đăng vẫn là `"success"` (video đang hoạt động), nhưng kết quả YouTube mang theo một mảng `warnings` mô tả lỗi hình thu nhỏ:

```json theme={"system"}
{
  "status": "success",
  "id": "<videoId>",
  "thumbnail": {
    "action": "post",
    "status": "error",
    "code": 307,
    "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.",
    "details": "<upstream message>"
  },
  "warnings": [
    {
      "feature": "thumbnail",
      "code": 307,
      "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.",
      "details": "<upstream message>"
    }
  ]
}
```

## Triệu chứng

Video YouTube của bạn xuất hiện trên kênh, nhưng hình thu nhỏ tùy chỉnh bạn cung cấp bị thiếu — YouTube sử dụng khung được tạo tự động thay thế. Phản hồi API trả về `status: "success"` với một mục nhập `warnings` hình thu nhỏ (`feature: "thumbnail"`, `code: 307`).

## Nguyên nhân phổ biến nhất: Kênh chưa được xác minh

Nguyên nhân chủ yếu của lỗi `403` hình thu nhỏ YouTube là **kênh YouTube chưa được xác minh**. YouTube yêu cầu xác minh kênh (qua điện thoại) trước khi chấp nhận tải lên hình thu nhỏ tùy chỉnh.

### Khắc phục: Xác minh kênh của bạn

1. Truy cập [https://www.youtube.com/verify](https://www.youtube.com/verify) và hoàn thành **xác minh qua điện thoại** cho kênh.
2. Ngoài ra, trong [YouTube Studio](https://studio.youtube.com/), vào *Settings → Channel*, chọn *Feature Eligibility*, và bật *Features that require phone verification*.
3. YouTube có thể mất tới 24 giờ để bật hình thu nhỏ tùy chỉnh sau khi xác minh. Xác minh qua điện thoại "Enabled" không đảm bảo YouTube sẽ cho phép tải lên hình thu nhỏ — YouTube cuối cùng quyết định về điều kiện.
4. Xác nhận bạn có thể tải lên hình thu nhỏ theo cách thủ công trong YouTube Studio. Nếu bạn không thể thực hiện theo cách thủ công, API cũng không thể.

## Nguyên nhân thứ hai: Quyền OAuth

Nếu kênh của bạn **đã được xác minh** và hình thu nhỏ vẫn thất bại với lỗi `403`, tài khoản YouTube được liên kết có thể thiếu các quyền cần thiết. Hãy thử **hủy liên kết và liên kết lại** tài khoản YouTube của bạn trong [Social Accounts](https://app.ayrshare.com/social-accounts) và cấp tất cả các quyền được yêu cầu trong quá trình liên kết lại.

Đối với tài khoản Brand / Content Owner (thường được sử dụng cho các kênh doanh nghiệp hoặc tổ chức), hãy đảm bảo tài khoản được liên kết có các quyền cần thiết — chúng tôi khuyến nghị quyền "Owner".

## Yêu cầu hình thu nhỏ trước khi đăng

Ayrshare xác thực `thumbNail` trước khi đăng nếu có thể. Để tránh lỗi hình thu nhỏ `307`, hãy đảm bảo hình thu nhỏ đáp ứng các yêu cầu sau:

<ul class="custom-bullets">
  <li>**Định dạng:** PNG hoặc JPG/JPEG. Phần mở rộng tệp phải kết thúc bằng <code>png</code>, <code>jpg</code>, hoặc <code>jpeg</code>.</li>
  <li>**Kích thước:** 2MB hoặc nhỏ hơn.</li>
  <li>**URL có thể truy cập:** URL <code>thumbNail</code> phải công khai truy cập được để Ayrshare có thể lấy được.</li>
</ul>

Vấn đề về hình thu nhỏ không bao giờ làm hỏng bài đăng. Nếu hình thu nhỏ chắc chắn không hợp lệ (phần mở rộng sai, được xác nhận trên 2MB hoặc không thể truy cập), Ayrshare sẽ bỏ qua nó trước khi video được tải lên, vẫn đăng video và báo cáo lý do trong `warnings`. Nếu lỗi chỉ có thể được xác định sau khi video được tải lên, video vẫn hoạt động và lỗi được đưa lên qua cùng mảng `warnings` được mô tả ở trên. Dù bằng cách nào, video vẫn được đăng và `status` vẫn là `"success"`.

## Liên quan

* [YouTube Post API — Hình thu nhỏ](/apis/post/social-networks/youtube#youtube-thumbnails)
* [Hướng dẫn phương tiện YouTube](/media-guidelines/youtube#thumbnails)
* [Mã lỗi — Mã 307](/errors/errors-ayrshare#youtube-thumbnail-errors-code-307)