Bắt đầu nhanh PHP

Hướng dẫn bắt đầu nhanh này giải thích cách thiết lập một ứng dụng dòng lệnh PHP đơn giản giúp thực hiện các 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:

1. 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.
2. 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.

Lưu ý: Nhìn chung, bạn có thể làm theo hướng dẫn cho ví dụ đầu tiên đối với mọi trường hợp sử dụng khoá API hoặc hướng dẫn đối với ví dụ thứ hai đối với mọi trường hợp sử dụng yêu cầu uỷ quyền bằng OAuth 2.0. Hãy xem các trường hợp sử dụng và công cụ mẫu mã để biết thêm ví dụ.

Điều kiện tiên quyết

Để chạy tính năng khởi động nhanh này, bạn cần:

• PHP 5.4 trở lên với giao diện dòng lệnh (CLI) và tiện ích JSON được cài đặt.
• Công cụ quản lý phần phụ thuộc Composer được cài đặt trên toàn cầu {: target="_blank"}
• Thư viện ứng dụng API của Google cho PHP:
  • Nếu trước đó bạn chưa cài đặt thư viện ứng dụng:

    composer require google/apiclient:^2.0

  • Nếu trước đây bạn đã cài đặt thư viện ứng dụng, thì bạn nên cập nhật thư viện đó để đảm bảo rằng bạn có các lớp mới nhất cho thư viện mà bạn đang thử nghiệm:

    composer update google/apiclient --with-dependencies

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:

1. 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.

2. Trong bảng thông tin xác thực, hãy tạo 2 thông tin xác thực:

   1. 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.

   2. Tạo mã ứng dụng khách OAuth 2.0 Đặt loại ứng dụng thành Khác. Bạn cần sử dụng thông tin xác thực OAuth 2.0 cho những yêu cầu yêu cầu người dùng phải uỷ quyền. Ví dụ: Bạn cần có sự cho phép của người dùng để truy xuất thông tin về kênh YouTube của người dùng hiện đã được xác thực.

      Tải tệp JSON chứa thông tin xác thực OAuth 2.0 xuống. Tệp có tên như client_secret_CLIENTID.json, trong đó CLIENTID là mã ứng dụng khách cho dự án của bạ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.

1. Mở tài liệu cho phương thức channel.list của API.

2. 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.

   

3. Ở 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:

   1. 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ố part và id. Giá trị thông số id, UC_x5XG1OV2P6uZZ5FSM9Ttw, là mã nhận dạng cho kênh YouTube của Google Developers.

   2. 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ộ.

      

4. Ở 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ẻ PHP.

5. Sao chép mã mẫu và lưu mã đó trong tệp có tên example.php.

6. Trong mẫu bạn đã tải xuống, hãy tìm chuỗi YOUR_API_KEY và 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.

7. Chạy mẫu từ dòng lệnh. Trong thư mục đang hoạt động, hãy chạy:

   php example.php

8. Mẫu sẽ thực thi yêu cầu và in phản hồi cho STDOUT.

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.

1. Quay lại tài liệu về phương thức channel.list của API.

2. 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 list cho "kênh của tôi".

3. 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:

   1. Trong mục tham số, thay vì đặt giá trị tham số id, bạn phải đặt giá trị tham số mine thành true. 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.

   2. 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.

      

4. Như ví dụ trước, chọn thẻ PHP, sao chép mã mẫu và lưu vào example.php.

   Trong mã, hãy tìm chuỗi YOUR_CLIENT_SECRET_FILE.json và thay thế bằng vị trí của tệp bí mật của ứng dụng mà bạn đã tải xuống ở bước 1 trong bước khởi động nhanh này.

5. Chạy mẫu từ dòng lệnh. Trong thư mục đang hoạt động, hãy chạy:

   php example.php

6. Sao chép URL từ bảng điều khiển và mở URL trong trình duyệt.

   Nếu chưa đăng nhập vào Tài khoản Google, bạn sẽ được nhắc đăng nhập. Nếu đăng nhập vào nhiều Tài khoản Google, bạn sẽ được yêu cầu chọn một tài khoản để sử dụng cho việc uỷ quyền.

7. Nhấp vào nút để cấp cho ứng dụng quyền truy cập vào các phạm vi được chỉ định trong mã mẫu.

8. Sao chép mã uỷ quyền từ trình duyệt rồi dán vào thiết bị đầu cuối của bạn. Sau đó, bạn có thể đóng thẻ trình duyệt được dùng cho luồng xác thực.

   Phản hồi API sẽ được in lại cho STDOUT.

Tài liệu đọc thêm

• Tài liệu trợ giúp của Google Developers Console
• Tài liệu về API Ứng dụng API của Google dành cho PHP
• Thư viện ứng dụng API của Google cho PHP trên GitHub và các lớp được tạo tự động cho API YouTube. (Trên trang này, hãy tìm thư mục YouTube và tệp YouTube.php.
• Tài liệu tham khảo về API dữ liệu của YouTube