Method: mediaItems.search

Yêu cầu HTTP

POST https://photoslibrary.googleapis.com/v1/mediaItems:search

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

{
  "albumId": string,
  "pageSize": integer,
  "pageToken": string,
  "filters": {
    object (Filters)
  },
  "orderBy": string
}

Nội dung phản hồi

{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "nextPageToken": string
}

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

• https://www.googleapis.com/auth/photoslibrary
• https://www.googleapis.com/auth/photoslibrary.readonly
• https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
• https://www.googleapis.com/auth/photoslibrary.readonly.originals

Các bộ lọc có thể áp dụng cho nội dung tìm kiếm về mục nội dung nghe nhìn. Nếu bạn chỉ định nhiều tuỳ chọn bộ lọc, thì các tuỳ chọn đó sẽ được coi là AND với nhau.

Bộ lọc này xác định ngày hoặc phạm vi ngày được phép cho nội dung nghe nhìn mà hệ thống trả về. Bạn có thể chọn một tập hợp các ngày cụ thể và một tập hợp phạm vi ngày. Các mục nội dung đa phương tiện đã tải lên mà không chỉ định ngày mà mục nội dung đa phương tiện được ghi lại sẽ không được trả về trong truy vấn bằng bộ lọc ngày. Thời gian tải lên máy chủ Google Photos không được dùng làm thời gian dự phòng trong trường hợp này.

Đại diện cho toàn bộ ngày theo lịch. Đặt day thành 0 khi chỉ tháng và năm là quan trọng, ví dụ: toàn bộ tháng 12 năm 2018. Đặt day và month thành 0 nếu chỉ năm là quan trọng, ví dụ: toàn bộ năm 2018. Đặt year thành 0 khi chỉ có ngày và tháng là quan trọng, chẳng hạn như ngày kỷ niệm hoặc sinh nhật.

Không được hỗ trợ: Đặt tất cả các giá trị thành 0, chỉ month thành 0 hoặc cả day và year thành 0 cùng một lúc.

Xác định một phạm vi ngày. Cả hai ngày phải có cùng định dạng. Để biết thêm thông tin, hãy xem Date.

Bộ lọc này cho phép bạn trả về các mục nội dung nghe nhìn dựa trên loại nội dung.

Có thể chỉ định danh sách danh mục để bao gồm và/hoặc danh sách danh mục cần loại trừ. Trong mỗi danh sách, các danh mục được kết hợp với OR.

Bộ lọc nội dung includedContentCategories: [c1, c2, c3] sẽ nhận được các mục nội dung đa phương tiện chứa (c1 HOẶC c2 HOẶC c3).

Bộ lọc nội dung excludedContentCategories: [c1, c2, c3] SẼ KHÔNG nhận được các mục nội dung nghe nhìn chứa (c1 HOẶC c2 HOẶC c3).

Bạn cũng có thể đưa một số danh mục vào trong khi loại trừ các danh mục khác, như trong ví dụ sau: includedContentCategories: [c1, c2], excludedContentCategories: [c3, c4]

Ví dụ trước sẽ nhận các mục nội dung đa phương tiện chứa (c1 OR c2) AND NOT (c3 OR c4). Danh mục xuất hiện trong includedContentategories không được xuất hiện ở excludedContentCategories.

Đây là một tập hợp các danh mục nội dung được xác định trước mà bạn có thể dùng để lọc.

Bộ lọc này xác định loại mục nội dung nghe nhìn sẽ được trả về, ví dụ: video hoặc ảnh. Chỉ hỗ trợ một loại nội dung nghe nhìn.

Tập hợp các loại nội dung nghe nhìn có thể tìm kiếm.

Bộ lọc này xác định các tính năng mà các mục nội dung nghe nhìn phải có.

Tập hợp các tính năng mà bạn có thể lọc.