Trang này được dịch bởi Cloud Translation API.

Triển khai: Kênh đăng ký

Các ví dụ sau đây cho biết cách sử dụng YouTube Data API (phiên bản 3) để thực hiện các chức năng liên quan đến gói thuê bao.

Truy xuất danh sách kênh đăng ký của một kênh

Gọi phương thức subscriptions.list để truy xuất danh sách kênh đăng ký của một kênh cụ thể. Có hai cách để xác định kênh:

Để truy xuất các gói thuê bao của người dùng hiện đã được xác thực, hãy đặt giá trị của tham số mine thành true. Xin lưu ý rằng bạn phải uỷ quyền cho một yêu cầu sử dụng tham số mine bằng OAuth 2.0.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mine=true
```
Để truy xuất danh sách kênh đăng ký của bất kỳ kênh nào khác, hãy đặt giá trị của thông số channelId thành mã nhận dạng kênh YouTube duy nhất của kênh đó. Ví dụ dưới đây truy xuất danh sách các kênh mà kênh TED đăng ký trên YouTube.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &channelId=UCAuUUnT6oDeKwE6v1NGQxug
```
Lưu ý: API sẽ trả về mã phản hồi HTTP 403 (Forbidden) nếu kênh được chỉ định không công khai các kênh đăng ký và yêu cầu không được chủ sở hữu kênh cho phép.

Xem tài liệu về phương thức subscriptions.list để biết mã mẫu.

Thêm đăng ký

Gọi phương thức subscriptions.insert để thêm gói thuê bao kênh. Bạn phải uỷ quyền cho yêu cầu này bằng OAuth 2.0. Nội dung yêu cầu là một tài nguyên subscription đặt các giá trị sau:

snippet.resourceId.kind chứa giá trị youtube#channel.
Thuộc tính snippet.resourceId.channelId xác định kênh đang được đăng ký. Giá trị thuộc tính là mã nhận dạng duy nhất của kênh YouTube. Bạn có thể lấy mã nhận dạng kênh theo nhiều cách, bao gồm cả việc gọi phương thức channels.list hoặc truy xuất kết quả tìm kiếm cho kênh.

Yêu cầu API bên dưới sẽ giúp bạn đăng ký kênh TED trên YouTube:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

Nội dung yêu cầu là:

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

Xem tài liệu của phương thức subscriptions.insert để biết mã mẫu.

Xoá gói thuê bao

Ví dụ này xoá một gói thuê bao. Bạn phải uỷ quyền cho yêu cầu này bằng OAuth 2.0. Ví dụ này có hai bước:

Bước 1: Truy xuất danh sách kênh đăng ký của kênh của người dùng đã xác thực

Gọi phương thức subscriptions.list để truy xuất danh sách gói thuê bao. Ví dụ trên về cách truy xuất danh sách kênh đăng ký của một kênh giải thích cách thực hiện yêu cầu này.

Ứng dụng gọi API có thể xử lý phản hồi API để hiển thị danh sách gói thuê bao, sử dụng mã nhận dạng của từng gói thuê bao làm khoá. Trong phản hồi, thuộc tính id của mỗi mục xác định mã thuê bao giúp nhận dạng duy nhất gói thuê bao tương ứng. Bạn sẽ sử dụng giá trị đó để xoá một mục khỏi danh sách ở bước tiếp theo.
Bước 2: Xoá gói thuê bao

Gọi phương thức subscriptions.delete để xoá gói thuê bao. Đặt tham số id của yêu cầu thành mã gói thuê bao cho gói thuê bao mà bạn muốn xoá. Bạn phải uỷ quyền cho yêu cầu này bằng OAuth 2.0.

Để hoàn tất yêu cầu trong Trình khám phá API, bạn cần đặt giá trị của thuộc tính id.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
        id=SUBSCRIPTION_ID
```

Xem tài liệu của phương thức subscriptions.delete để biết mã mẫu.

Truy xuất danh sách người đăng ký kênh của người dùng được uỷ quyền

Để truy xuất danh sách các kênh đăng ký kênh của người dùng hiện đã xác thực, hãy gọi phương thức subscriptions.list và đặt giá trị của thông số mySubscribers thành true. Yêu cầu phải được uỷ quyền bằng OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true