Method: labels.get

Lấy nhãn theo tên tài nguyên. Tên tài nguyên có thể là bất kỳ giá trị nào sau đây:

  • labels/{id} – Xem labels/{id}@latest
  • labels/{id}@latest – Xem bản sửa đổi mới nhất của nhãn.
  • labels/{id}@published – Xem bản sửa đổi đã xuất bản hiện tại của nhãn.
  • labels/{id}@{revisionId} – Lấy nhãn tại mã bản sửa đổi đã chỉ định.

Yêu cầu HTTP

GET https://drivelabels.googleapis.com/v2/{name=labels/*}

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

Tham số đường dẫn

Thông số
name

string

Bắt buộc. Tên tài nguyên nhãn.

Có thể là bất kỳ giá trị nào sau đây:

  • labels/{id} (tương đương với labels/{id}@ấy)
  • labels/{id}@latest
  • labels/{id}@published
  • labels/{id}@{revisionId}

Tham số truy vấn

Thông số
useAdminAccess

boolean

Đặt thành true để sử dụng thông tin đăng nhập của quản trị viên của người dùng. Trước khi cho phép truy cập, máy chủ xác minh rằng người dùng là quản trị viên của nhãn.

languageCode

string

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

view

enum (LabelView)

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

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

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Label.

Phạm vi uỷ quyền

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

  • 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 bài viết Hướng dẫn uỷ quyền.