Làm quen với Library API

API Thư viện cho phép bạn tương tác với ảnh, video và album trong thư viện Google Photos của người dùng, nhưng có một điểm quan trọng là bạn chỉ có thể truy cập và quản lý nội dung do ứng dụng của bạn tạo ra.

Trước khi bắt đầu

Các trường hợp sử dụng chính của API Thư viện

Library API là lựa chọn lý tưởng cho các trường hợp ứng dụng của bạn cần:

  • Tải lên và lưu trữ nội dung nghe nhìn: Nhập ảnh và video (do ứng dụng của bạn tạo) một cách an toàn vào thư viện Google Photos của người dùng.
  • Sắp xếp nội dung: Tạo và quản lý album để giúp người dùng sắp xếp nội dung nghe nhìn liên quan đến ứng dụng của họ.
  • Cải thiện ảnh và album: Thêm ngữ cảnh vào các mục nội dung nghe nhìn và album thông qua các thông tin bổ sung như tiêu đề, nội dung mô tả hoặc thông tin vị trí.
  • Truy cập vào dữ liệu do ứng dụng tạo: Truy xuất và tương tác với ảnh, video và album mà ứng dụng của bạn đã tạo trước đó.

Quy trình điển hình của API Thư viện

Mặc dù Thư viện API cung cấp nhiều chức năng, nhưng quy trình làm việc phổ biến có thể bao gồm các bước sau:

  1. Tải nội dung nghe nhìn lên: Sử dụng điểm cuối tải lên để tải các byte ảnh hoặc video lên Google Photos một cách an toàn. Bước này sẽ tạo một uploadToken.

  2. Tạo mục nội dung nghe nhìn: Sử dụng phương thức mediaItems.batchCreate, cung cấp uploadToken để tạo mục nội dung nghe nhìn trong thư viện của người dùng.

  3. Tạo album (không bắt buộc): Sử dụng phương thức albums.create để tạo album trong thư viện của người dùng nhằm sắp xếp các mục nội dung nghe nhìn.

  4. Quản lý album:

    • Thêm các mục nội dung nghe nhìn (do ứng dụng của bạn tạo) vào album bằng cách sử dụng albums.batchAddMediaItems.
    • Xoá các mục nội dung nghe nhìn khỏi các album bằng albums.batchRemoveMediaItems.
    • Thêm nội dung làm phong phú vào album (như tiêu đề hoặc vị trí) bằng cách sử dụng albums.addEnrichment.
    • Truy xuất thông tin về các album cụ thể bằng albums.get.
    • Liệt kê các album do ứng dụng của bạn tạo bằng cách sử dụng albums.list.

  5. Truy cập nội dung nghe nhìn do ứng dụng tạo:

    • Truy xuất thông tin chi tiết về các mục nội dung nghe nhìn cụ thể bằng mediaItems.get hoặc mediaItems.batchGet.
    • Tìm kiếm các mục nội dung nghe nhìn do ứng dụng của bạn tạo bằng mediaItems.search.
    • Liệt kê các mục nội dung nghe nhìn trong một đĩa nhạc cụ thể do ứng dụng tạo bằng cách sử dụng mediaItems.search với mã đĩa nhạc.

Các bước tiếp theo

  • Xem lại tài liệu tham khảo: Khám phá tài liệu tham khảo API Thư viện chi tiết để tìm hiểu về tất cả các phương thức và tham số hiện có.
  • Thử các mẫu: Hãy xem mẫu của chúng tôi để xem Thư viện API hoạt động và lấy cảm hứng cho quá trình tích hợp.