Hướng dẫn bắt đầu nhanh này giải thích cách thiết lập một trang đơn giản để gửi yêu cầu đến API Dữ liệu YouTube. Hướng dẫn nhanh này thực sự giải thích cách đưa ra hai yêu cầu API:
- Bạn sẽ sử dụng khoá API để xác định ứng dụng của mình, nhằm truy xuất thông tin về kênh YouTube của Google Developers.
- Bạn sẽ sử dụng mã ứng dụng khách OAuth 2.0 để gửi yêu cầu được uỷ quyền truy xuất thông tin về kênh YouTube của riêng mình.
Điều kiện tiên quyết
Để chạy tính năng khởi động nhanh này, bạn cần:
- Python 2.4 trở lên (để cung cấp một máy chủ web)
- Quyền truy cập vào Internet và trình duyệt web.
- Tài khoản Google.
Bước 1: Thiết lập dự án và thông tin xác thực
Tạo hoặc chọn một dự án trong Bảng điều khiển API. Hoàn thành các nhiệm vụ sau trong Bảng điều khiển API cho dự án của bạn:
Trong bảng điều khiển thư viện, hãy tìm kiếm API dữ liệu YouTube phiên bản 3. Nhấp vào trang thông tin cho API đó và đảm bảo API đã được bật cho dự án của bạn.
Trong bảng thông tin xác thực, hãy tạo 2 thông tin xác thực:
Tạo khoá API Bạn sẽ sử dụng khoá API để tạo các yêu cầu API không yêu cầu người dùng uỷ quyền. Ví dụ: Bạn không cần uỷ quyền của người dùng để truy xuất thông tin về một kênh YouTube công khai.
Tạo mã ứng dụng khách OAuth 2.0 Đặt loại ứng dụng thành Ứng dụng web. Bạn cần sử dụng thông tin xác thực OAuth 2.0 cho các yêu cầu yêu cầu người dùng phải uỷ quyền. Ví dụ: bạn cần người dùng cho phép để truy xuất thông tin về kênh YouTube của người dùng hiện đã được xác thực.
Trong trường Nguồn gốc JavaScript được cho phép, hãy nhập URL
http://localhost:8000. Bạn có thể để trống trường URI chuyển hướng được ủy quyền.
Bước 2: Thiết lập và chạy mẫu
Sử dụng tiện ích APIs Explorer trong bảng điều khiển bên để lấy mã mẫu để truy xuất thông tin về kênh YouTube của Google Developers. Yêu cầu này sử dụng khoá API để xác định ứng dụng của bạn và không yêu cầu người dùng uỷ quyền hay bất kỳ quyền đặc biệt nào của người dùng chạy mẫu.
- Mở tài liệu cho phương thức channel.list của API.
Trên trang đó, mục "Các trường hợp sử dụng phổ biến" chứa một bảng giải thích một số cách phổ biến mà phương thức này được sử dụng. Trang thông tin đầu tiên trong bảng là để liệt kê kết quả theo mã nhận dạng kênh.
Nhấp vào biểu tượng mã cho trang thông tin đầu tiên để mở và điền sẵn Trình khám phá API toàn màn hình.
Ở bên trái Trình khám phá API toàn màn hình hiển thị các thông tin sau:
Dưới tiêu đề Yêu cầu tham số, có một danh sách các tham số mà phương thức này hỗ trợ. Bạn phải đặt các giá trị thông số
partvàid. Giá trị thông sốid,UC_x5XG1OV2P6uZZ5FSM9Ttw, là mã nhận dạng cho kênh YouTube của Google Developers.Bên dưới các thông số, có một phần có tên là Thông tin xác thực. Trình đơn kéo xuống trong phần đó sẽ hiển thị giá trị Khoá API. Theo mặc định, Trình khám phá API sử dụng thông tin đăng nhập minh hoạ để giúp bạn bắt đầu dễ dàng hơn. Nhưng bạn sẽ sử dụng khoá API của riêng mình để chạy mẫu cục bộ.
Ở bên phải của API toàn màn hình cho phép bạn khám phá các thẻ chứa mã mẫu bằng nhiều ngôn ngữ. Chọn thẻ JavaScript.
Sao chép mã mẫu và lưu mã đó trong tệp có tên
example.html.Trong mẫu bạn đã tải xuống, hãy tìm chuỗi
YOUR_API_KEYvà thay thế bằng khoá API mà bạn đã tạo ở bước 1 của quá trình bắt đầu nhanh này.Khởi động máy chủ web bằng lệnh sau trong thư mục đang hoạt động:
Python
python -m SimpleHTTPServer 8000Python
python -m http.server 8000Mở tệp example.html trong trình duyệt của bạn. Đồng thời mở công cụ cho nhà phát triển của trình duyệt, chẳng hạn như "Công cụ cho nhà phát triển" trong trình duyệt Chrome.
Nhấp vào nút load trên trang để tải Thư viện ứng dụng API Google cho JavaScript. Sau khi bạn nhấp vào nút, bảng điều khiển dành cho nhà phát triển sẽ hiển thị ghi chú cho biết ứng dụng GAPI đã tải.
Nhấp vào nút thực thi để gửi yêu cầu API. Khi đó, bảng điều khiển dành cho nhà phát triển sẽ hiển thị phản hồi của API.
Bước 3: Chạy một yêu cầu được ủy quyền
Trong bước này, bạn sẽ sửa đổi mã mẫu để thay vì truy xuất thông tin về kênh YouTube Google Developers, mã này sẽ truy xuất thông tin về kênh YouTube của bạn. Yêu cầu này cần được người dùng cho phép.
Quay lại tài liệu về phương thức channel.list của API.
Trong phần "Các trường hợp sử dụng phổ biến", hãy nhấp vào biểu tượng mã cho danh sách thứ ba trong bảng. Trường hợp sử dụng đó là gọi phương thức
listcho "kênh của tôi".Xin nhắc lại, ở bên trái Trình khám phá API toàn màn hình, bạn sẽ thấy danh sách các thông số đứng trước phần Credentials (Thông tin xác thực). Tuy nhiên, có hai thay đổi trong ví dụ này, trong đó bạn truy xuất thông tin về kênh Google Developers:
Trong mục tham số, thay vì đặt giá trị tham số
id, bạn phải đặt giá trị tham sốminethànhtrue. Thao tác này hướng dẫn máy chủ API truy xuất thông tin về kênh của người dùng hiện đã được xác thực.Trong phần Credentials (Thông tin xác thực), trình đơn kéo xuống sẽ chọn tuỳ chọn cho Google OAuth 2.0.
Ngoài ra, nếu nhấp vào đường liên kết Show scope (Hiện phạm vi), bạn nên kiểm tra phạm vi https://www.googleapis.com/auth/youtube.readonly.
Như trong ví dụ trước, hãy chọn thẻ JavaScript, sao chép mã mẫu và lưu vào
example.html.Trong mã, hãy tìm chuỗi
YOUR_CLIENT_IDvà thay thế bằng mã ứng dụng khách mà bạn đã tạo ở bước 1 của quá trình khởi động nhanh này.Khởi động máy chủ web bằng lệnh sau trong thư mục đang hoạt động:
Python
python -m SimpleHTTPServer 8000Python
python -m http.server 8000Truy cập vào tệp
http://localhost:8000/example.htmltrên trình duyệt. Mở công cụ cho nhà phát triển trên trình duyệt, chẳng hạn như "Công cụ cho nhà phát triển" trong trình duyệt Chrome.Nhấp vào nút uỷ quyền và tải trên trang để tải Thư viện ứng dụng JavaScript cho Google API và bắt đầu quy trình uỷ quyền. Bạn sẽ được nhắc cấp cho ứng dụng quyền đọc dữ liệu từ tài khoản YouTube của bạn.
Nếu bạn cấp quyền, bảng điều khiển của nhà phát triển sẽ hiển thị thông báo cho biết quá trình đăng nhập đã thành công và ứng dụng API đã được tải.
Nhấp vào nút thực thi để gửi yêu cầu API. Khi đó, bảng điều khiển dành cho nhà phát triển sẽ hiển thị phản hồi của API.