Để bắt đầu sử dụng API Thư viện Google Photos bằng thư viện ứng dụng Java, bạn cần phải 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 bạn làm việc đó, hãy định cấu hình dự án của mình bằng cách bật API qua Bảng điều khiển API của Google và thiết lập mã ứng dụng khách 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 anbom trong Thư viện Google Photos hoặc tải các mục nội dung nghe nhìn lên Google Photos, người dùng 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 từ đó sử dụng Library API. 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 Tài khoản.
Định cấu hình ứng dụng
Bật API
Bạn phải bật API Thư viện cho dự án thì mới có thể sử dụng API này.
- 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, từ trình đơn Điều hướng, hãy chọn 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ả chính xác và nhấp vào 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 . Ví dụ này sử dụng một ứng dụng trong đó toàn bộ quy trình OAuth là đã xử lý ở phía máy chủ, chẳng hạn như một 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 đăng nhập, nhấp vào Tạo thông tin xác thực > Mã ứng dụng 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à từ đó ứng dụng của bạn được phép truy cập vào các API của Google như sau:
- Hãy nhập một tên để xác định mã ứng dụng khách.
Trong trường Nguồn gốc JavaScript được cho phép, hãy nhập nguồn gốc cho . 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 nguồn gốc giao thức, miền hoặc miền con. URL mà bạn nhập được phép bắt đầu một yêu cầu OAuth.
Ví dụ sau đây thể hiện 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 chính thức.http://localhost:8080 https://myproductionurl.example.comTrường URI chuyển hướng được phép là điểm cuối nhận phản hồi từ máy chủ OAuth 2.0. Thông thường, trong đó có môi trường phát triển và trỏ tới một đường dẫn trong ứng dụng của bạn.
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ề khách hàng của bạn bao gồm sau:
- Client ID
- 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 Xác thực của Google cho Java hoạt động với thư viện ứng dụng này.
Trước khi bạn có thể khởi 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. "Ứng dụng chưa được xác minh" xuất hiện trên khi kiểm thử ứng dụng cho đến khi ứng dụng 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 xuống và cài đặt thư viện ứng dụng API Thư viện Google Photos cho Java cùng với các phần phụ thuộc trên GitHub. Sau đó, hãy thiết lập thông tin đăng nhập OAuth2 cho Java.
Tùy chọn tải xuống
Dưới đây là một số tuỳ chọn để 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 đây vào
pom.xmlMaven .<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 bản phát hành chứa các cấu phần phần mềm khác nhau cho mỗi bản phát hành thư viện, bao gồm cả cá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.gitở dấu nhắc lệnh. - Bạn sẽ nhận được một thư mục
java-photoslibrary. Chuyển đến đó 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. Truy cập./gradlew tasksđể xem các nhiệm vụ hiện có.
- Chạy
Thiết lập thông tin đăng nhập 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, tham khảo bài viết Sử dụng OAuth 2.0 với Thư viện ứng dụng API của Google để 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ã bên dưới để thực hiện lệnh gọi API đầu tiên bằng cách sử dụ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ử.