Trang này được dịch bởi Cloud Translation API.

Bắt đầu sử dụng thư viện ứng dụng PHP

Để bắt đầu sử dụng API Thư viện Google Photos với thư viện ứng dụng PHP, 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 mình. Trước khi làm điều đó, 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:
1. Để xác định mã ứng dụng khách, hãy nhập tên.
2. 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.com
```
3. Trườ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/callback
```
4. Nhấp vào Tạo.

Từ hộp thoại ứng dụng OAuth thu được, hãy tải tệp JSON chứa cấu hình ứng dụng của bạn xuống. Thông tin chi tiết về khách hàng của bạn bao gồm những thông tin sau:
- Client ID
- Mật khẩu ứng dụng khách
Sau này, tệp JSON này sẽ được dùng để thiết lập thư viện Xác thực của Google dành cho PHP (hoạt động với thư viện ứng dụng 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.

Thiết lập thư viện ứng dụng

Thư viện ứng dụng PHP sẽ xử lý tất cả các lệnh gọi API phụ trợ cho bạn cũng như hiển thị các đối tượng thân thiện để thao tác, 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 của Thư viện Google Photos dành cho PHP cùng với các phần phụ thuộc từ GitHub. Sau đó, hãy thiết lập thông tin đăng nhập OAuth2 của bạn 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 của bạn. Chạy lệnh sau để thêm thư viện vào cấu hình dự án của bạn và tải thư viện xuống 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 tarball nén xuống.

Thiết lập thông tin đăng nhập OAuth2 của bạn 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 dành cho PHP. Để 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 API của Google cho 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 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ó nhiều mẫu hơn trên GitHub để bạn dùng thử.