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

Triển khai: Gói thuê bao

Những ví dụ sau đây minh họa cách sử dụng YouTube Data API (v3) để thực hiện các chức năng liên quan đến gói thuê bao.

Truy xuất đăng ký của kênh

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

Để truy xuất gói thuê bao của người dùng hiện đã xác thực, hãy đặt giá trị của thông số mine thành true. Lưu ý rằng yêu cầu sử dụng tham số mine phải được cấp phép 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 đăng ký cho bất kỳ kênh nào khác, hãy đặt giá trị của thông số channelId thành ID 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 đã đăng ký kênh TED 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 tiết lộ công khai các kênh đăng ký và yêu cầu của chủ sở hữu kênh không uỷ quyền.

Xem tài liệu của phương thức subscriptions.list cho các mã mẫu.

Thêm đăng ký

Gọi phương thức subscriptions.insert để thêm gói thuê bao của kênh. Yêu cầu này phải được cấp phép bằng OAuth 2.0. Phần 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 kênh YouTube duy nhất. 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 trên kênh.

Yêu cầu API dưới đây 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 của 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 cho các mã mẫu.

Xoá gói thuê bao

Ví dụ này sẽ xoá một gói thuê bao. Yêu cầu này phải được cấp phép bằng OAuth 2.0. Ví dụ này có hai bước:

Bước 1: Truy xuất gói thuê bao cho 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ề việc truy xuất đăng ký của kênh giải thích cách đưa ra yêu cầu này.

Ứng dụng gọi API có thể xử lý phản hồi API để cho thấy danh sách gói thuê bao, trong đó sử dụng mã nhận dạng của mỗi gói thuê bao làm khoá. Trong phản hồi, thuộc tính id của mỗi mục sẽ xác định mã nhận dạng gói 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 của gói thuê bao mà bạn muốn xoá. Yêu cầu này phải được cấp phép bằng OAuth 2.0.

Để hoàn tất yêu cầu trong APIs Explorer, 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 cho các 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 đã được 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 này phải được cấp phép bằng OAuth 2.0.

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