Để bắt đầu sử dụng API Google Photos bằng thư viện ứng dụng Java, bạn cần thiết lập thư viện ứng dụng trong môi trường phát triển của bạn. Trước khi làm như vậy, hãy định cấu hình dự án bằng cách bật API thông qua Google API Console và thiết lập mã ứng dụng OAuth 2.0.
Ứng dụng của bạn 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ẽ uỷ quyền cho 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 đăng nhập, xác thực và nhờ đó sử dụng các API Photos. API Photos 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
Trước khi có thể sử dụng API Photos, 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 dự án mới.
- Để mở Thư viện API của Google, trong trình đơn Điều hướng, hãy chọn API và dịch vụ > Thư viện.
- Tìm "API Google Photos". Chọn kết quả chính xác và nhấp vào Bật.
Yêu cầu mã ứng dụng khách OAuth 2.0
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ã này 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ư quy trình trong các mẫu của chúng tôi. Quá trình thiết lập có thể khác nhau cho trường hợp triển khai khác.
- Truy cập Google API Console rồi chọn dự án của bạn.
- Trên 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ý nguồn gốc mà ứng dụng của bạn được phép truy cập vào API của Google như sau:
- Để xác định mã khách hàng, hãy nhập tên.
Trong trường Nguồn gốc JavaScript được uỷ quyền, 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 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 nguồn gốc giao thức, miền hoặc miền con. Các URL mà 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 phát hành công khai.http://localhost:8080 https://myproductionurl.example.comTrường URI chuyển hướng được uỷ quyền là điểm cuối nhận được phản hồi từ máy chủ OAuth 2.0. Thông thường, đường dẫn 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 tải tệp JSON xuống chứa cấu hình ứng dụng của bạn. Thông tin chi tiết về ứng dụng khách bao gồm:
- ID khách hàng
- Mật khẩu ứng dụng khách
Tệp JSON này sẽ được dùng sau để thiết lập thư viện Google Auth cho Java. Thư viện này hoạt động với thư viện ứng dụng này.
Trước khi bạn có thể ra mắt một ứng dụng công khai truy cập vào API Photos, ứ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.
Thiết lập thư viện ứng dụng
Thư viện ứng dụng Java xử lý tất cả các lệnh gọi API phụ trợ cho bạn và hiển thị các đối tượng dễ sử dụng, bao gồm cả mã mẫu cho một số tác vụ API phổ biến. Trước tiên, hãy tải và cài đặt thư viện ứng dụng API Google Photos cho Java với các phần phụ thuộc trên GitHub. Sau đó, hãy thiết lập thông tin xác thực OAuth2 cho Java.
Tùy chọn tải xuống
Dưới đây là một số cách để tải thư viện ứng dụng xuống:
Phần phụ thuộc Gradle:
Để sử dụng thư viện này với Gradle, hãy thêm phần phụ thuộc sau vào tệp
build.gradle.repositories { mavenCentral() } dependencies { compile 'com.google.photos.library:google-photos-library-client:1.7.3' }Phần phụ thuộc Maven:
Để sử dụng thư viện này với Maven, hãy thêm nội dung sau vào tệp
pom.xmlcủa Maven.<dependency> <groupId>com.google.photos.library</groupId> <artifactId>google-photos-library-client</artifactId> <version>1.7.3</version> </dependency>Tải bản phát hành xuống:
Trang phát hành chứa nhiều cấu phần phần mềm cho mỗi bản phát hành thư viện, bao gồm cả tệp jar.
Nhân bản kho lưu trữ:
Sử dụng phương thức này nếu bạn muốn thay đổi hoặc đóng góp cho thư viện này, cho ví dụ như gửi yêu cầu lấy dữ liệu hoặc nếu bạn muốn thử các mẫu của chúng tôi. Khi sao chép kho lưu trữ, thì tất cả tệp trong kho lưu trữ này sẽ được tải xuống.
- Chạy
git clone https://github.com/google/java-photoslibrary.gittại dấu nhắc lệnh. - Bạn sẽ nhận được một thư mục
java-photoslibrary. Chuyển đến tệp này bằng cách chạycd java-photoslibrary. - Mở tệp
build.gradletrong IDE hoặc chạy./gradlew assembletại lời nhắc lệnh để tạo dự án. Xem./gradlew tasksđể xem các tác vụ có sẵn.
- Chạy
Thiết lập thông tin xác thực OAuth2 cho Java
Thư viện ứng dụng này hoạt động với Thư viện xác thực của Google cho Java. Để biết thêm thông tin, hãy tham khảo bài viết Sử dụng OAuth 2.0 với Thư viện ứng dụng Google API cho Java.
Chỉ định cấu hình OAuth của ứng dụng trong CredentialsProvider khi
tạo PhotoLibrarySettings cho đối tượng PhotosLibraryClient.
Thử một số mẫu
Hãy thử mã dưới đây để thực hiện lệnh gọi API đầu tiên bằng thư viện ứng dụng Java.
// Set up the Photos Library Client that interacts with the API
PhotosLibrarySettings settings =
PhotosLibrarySettings.newBuilder()
.setCredentialsProvider(
FixedCredentialsProvider.create(/* Add credentials here. */))
.build();
try (PhotosLibraryClient photosLibraryClient =
PhotosLibraryClient.initialize(settings)) {
// Create a new Album with at title
Album createdAlbum = photosLibraryClient.createAlbum("My Album");
// Get some properties from the album, such as its ID and product URL
String id = album.getId();
String url = album.getProductUrl();
} catch (ApiException e) {
// Error during album creation
}
Có thêm mẫu trên GitHub để bạn dùng thử.