Method: labels.list

Liệt kê nhãn. Để biết thêm thông tin, hãy xem bài viết Tìm nhãn.

Yêu cầu HTTP

GET https://drivelabels.googleapis.com/v2/labels

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

Tham số truy vấn

Thông số
publishedOnly

boolean

Có chỉ bao gồm các nhãn đã xuất bản trong kết quả hay không.

  • Khi true, chỉ những bản sửa đổi nhãn đã xuất bản hiện tại mới được trả về. Có cả nhãn bị vô hiệu hoá. Tên tài nguyên nhãn được trả về tham chiếu đến bản sửa đổi đã xuất bản (labels/{id}/{revisionId}).
  • Khi false, các bản sửa đổi nhãn hiện tại sẽ được trả về, có thể chưa được xuất bản. Tên tài nguyên nhãn được trả về không tham chiếu đến một bản sửa đổi cụ thể (labels/{id}).
customer

string

Khách hàng để phạm vi yêu cầu này. Ví dụ: customers/abcd1234. Nếu bạn không đặt, hệ thống sẽ trả về tất cả nhãn trong khách hàng hiện tại.
languageCode

string

Mã ngôn ngữ BCP-47 dùng để đánh giá nhãn trường được bản địa hoá. Khi không được chỉ định, các giá trị bằng ngôn ngữ được định cấu hình mặc định sẽ được sử dụng.
pageSize

integer

Số lượng nhãn tối đa cần trả về trên mỗi trang. Mặc định: 50. Tối đa: 200.
pageToken

string

Mã thông báo của trang cần trả về.
view

enum (LabelView)

Khi được chỉ định, chỉ một số trường thuộc khung hiển thị được chỉ định mới được trả về.

Tham số hợp nhất access.

access chỉ có thể là một trong những trạng thái sau:
useAdminAccess

boolean

Đặt thành true để sử dụng thông tin đăng nhập quản trị của người dùng. Thao tác này sẽ trả về tất cả nhãn trong khách hàng.
minimumRole

enum (LabelRole)

Chỉ định cấp truy cập mà người dùng phải có đối với các nhãn được trả về. Vai trò tối thiểu mà người dùng phải có trên nhãn. Giá trị mặc định là READER.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi cho việc liệt kê nhãn.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Trường
labels[]

object (Label)

Nhãn.
nextPageToken

string

Mã thông báo của trang tiếp theo trong phản hồi.

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/drive.labels
  • https://www.googleapis.com/auth/drive.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.