Method: labels.get

Lấy nhãn theo tên tài nguyên. Để biết thêm thông tin, hãy xem bài viết Tìm nhãn.

Tên tài nguyên có thể là bất kỳ tên nào sau đây:

  • labels/{id} – Xem labels/{id}@latest
  • labels/{id}@latest – Lấy bản sửa đổi mới nhất của nhãn.
  • labels/{id}@published – Nhận 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ã nhận dạng bản sửa đổi được 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 trong số:

  • labels/{id} (tương đương với labels/{id}@latest)
  • 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 quản trị của người dùng. Máy chủ sẽ xác minh rằng người dùng là quản trị viên của nhãn trước khi cho phép truy cập.
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.
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ề.

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:

  • 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.