Để bắt đầu sử dụng API Thư viện Google Photos, hãy định cấu hình dự án của bạn bằng cách bật API thông qua Google API Console và thiết lập mã ứng dụng khách OAuth 2.0.
Ứng dụng của bạn sẽ tương tác với Google Photos thay mặt cho người dùng Google Photos. Ví dụ: khi bạn tạo album trong thư viện Google Photos của người dùng hoặc tải các mục nội dung nghe nhìn lên tài khoản Google Photos của người dùng, người dùng sẽ cho phép các yêu cầu API này thông qua giao thức OAuth 2.0.
Mã ứng dụng khách OAuth 2.0 cho phép người dùng ứng dụng của bạn đăng nhập, xác thực và theo đó sử dụng API Thư viện. API thư viện không hỗ trợ tài khoản dịch vụ. Để sử dụng API này, người dùng phải đăng nhập vào một Tài khoản Google hợp lệ.
Định cấu hình ứng dụng
Bật API
Để có thể sử dụng API Thư viện, bạn phải bật API này cho dự án của mình.
- Chuyển đến Google API Console.
- Trên thanh trình đơn, hãy chọn một dự án hoặc tạo một dự án mới.
- Để mở Thư viện API của Google, trong trình đơn Điều hướng, hãy chọn APIs & Services > Library (API và dịch vụ > Thư viện).
- Tìm "Google Photos Library API" (API Thư viện Google Photos). Chọn kết quả đúng rồi nhấp vào Enable (Bật).
Yêu cầu mã ứng dụng khách OAuth 2.0
Hãy làm theo các bước bên dưới để yêu cầu mã ứng dụng khách OAuth và định cấu hình mã đó cho ứng dụng của bạn. Ví dụ này sử dụng một ứng dụng trong đó toàn bộ quy trình OAuth được xử lý phía máy chủ, chẳng hạn như ứng dụng trong các mẫu của chúng tôi. Quy trình thiết lập có thể thay đổi đối với các trường hợp triển khai khác.
- Chuyển đến Google API Console rồi chọn dự án của bạn.
- Từ trình đơn, hãy chọn API và dịch vụ > Thông tin xác thực.
- Trên trang Thông tin xác thực, hãy nhấp vào Tạo thông tin xác thực > Mã ứng dụng khách OAuth.
- Chọn Loại ứng dụng. Trong ví dụ này, loại ứng dụng là Ứng dụng web.
Đăng ký những nguồn gốc mà ứng dụng của bạn được phép truy cập vào các API của Google như sau:
- Để xác định mã ứng dụng khách, hãy nhập tên.
Trong trường Nguồn gốc JavaScript được cho phép, hãy nhập nguồn gốc cho ứng dụng của bạn. Trường này không cho phép sử dụng ký tự đại diện.
Bạn có thể nhập nhiều nguồn gốc để cho phép ứng dụng chạy trên nhiều giao thức, miền hoặc miền con. Các URL bạn nhập được phép bắt đầu một yêu cầu OAuth.
Ví dụ sau đây cho thấy một URL phát triển cục bộ (các mẫu của chúng tôi sử dụng
localhost:8080) và một URL chính thức.http://localhost:8080 https://myproductionurl.example.comTrường URI chuyển hướng được cho phép là điểm cuối nhận phản hồi từ máy chủ OAuth 2.0. Thông thường, lớp này bao gồm môi trường phát triển và trỏ đến một đường dẫn trong ứng dụng.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callbackNhấp vào Tạo.
-
Trong hộp thoại ứng dụng OAuth thu được, hãy sao chép nội dung sau:
- Client ID
- Mật khẩu ứng dụng khách
Ứng dụng của bạn có thể truy cập vào các API của Google đã bật bằng cách sử dụng những giá trị này.
Trước khi bạn có thể chạy một ứng dụng công khai có truy cập vào API Thư viện, ứng dụng của bạn phải được Google xem xét. Thông báo "Ứng dụng chưa được xác minh" sẽ xuất hiện trên màn hình khi bạn kiểm thử ứng dụng cho đến khi ứng dụng được xác minh.
Dùng thử mẫu
Lúc này, bạn đã định cấu hình dự án để sử dụng với API thư viện, hãy xem ứng dụng mẫu trên GitHub. Ứng dụng mẫu minh hoạ cách tạo một khung ảnh thông minh bằng API Thư viện.