Để bắt đầu sử dụng API Thư viện Google Photos cùng với thư viện ứng dụng PHP, 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 Các 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.com
Trườ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/callback
Nhấ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 PHP 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 PHP 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 PHP cùng với phần phụ thuộc từ GitHub. Sau đó, hãy thiết lập thông tin đăng nhập OAuth2 cho PHP.
Tùy chọn tải xuống
Sử dụng trình soạn thảo
để đưa thư viện vào dưới dạng phần phụ thuộc trong môi trường phát triển. Chạy
sau đây để thêm thư viện vào cấu hình dự án của bạn và tải xuống
nó vào thư mục vendor/
.
composer require google/photos-library
Ngoài ra, bạn cũng có thể sao chép kho lưu trữ hoặc tải tệp nén xuống tarball.
Thiết lập thông tin đăng nhập OAuth2 cho PHP
Thư viện ứng dụng này hoạt động với Thư viện xác thực của Google cho PHP. Để 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 để PHP.
Sử dụng thông tin xác thực do thư viện xác thực trả về khi thiết lập
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 của bạn bằng thư viện ứng dụng PHP.
use Google\Auth\Credentials\UserRefreshCredentials;
use Google\Photos\Library\V1\PhotosLibraryClient;
use Google\Photos\Library\V1\PhotosLibraryResourceFactory;
try {
// Use the OAuth flow provided by the Google API Client Auth library
// to authenticate users. See the file /src/common/common.php in the samples for a complete
// authentication example.
$authCredentials = new UserRefreshCredentials( /* Add your scope, client secret and refresh token here */ );
// Set up the Photos Library Client that interacts with the API
$photosLibraryClient = new PhotosLibraryClient(['credentials' => $authCredentials]);
// Create a new Album object with at title
$newAlbum = PhotosLibraryResourceFactory::album("My Album");
// Make the call to the Library API to create the new album
$createdAlbum = $photosLibraryClient->createAlbum($newAlbum);
// The creation call returns the ID of the new album
$albumId = $createdAlbum->getId();
} catch (\Google\ApiCore\ApiException $exception) {
// Error during album creation
} catch (\Google\ApiCore\ValidationException $e) {
// Error during client creation
echo $exception;
}
Có thêm mẫu trên GitHub để bạn thử.