REST Resource: users

Tài nguyên: Người dùng

Tài nguyên người dùng.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "email": string,
  "accessState": enum (AccessState),
  "expirationTime": string,
  "partial": boolean,
  "developerAccountPermissions": [
    enum (DeveloperLevelPermission)
  ],
  "grants": [
    {
      object (Grant)
    }
  ]
}
Trường
name

string

Bắt buộc. Tên tài nguyên cho người dùng này, theo mẫu "developers/{developer}/users/{email}".

email

string

Không thể thay đổi. Địa chỉ email của người dùng.

accessState

enum (AccessState)

Chỉ có đầu ra. Trạng thái quyền truy cập của người dùng vào Play Console.

expirationTime

string (Timestamp format)

Thời gian hết hạn quyền truy cập của người dùng (nếu được đặt). Khi đặt giá trị này, bạn phải luôn đặt giá trị đó là thời điểm trong tương lai.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

partial

boolean

Chỉ có đầu ra. Liệu người dùng có thêm quyền nào khác không được thể hiện ở đây hay không. Điều này có thể xảy ra nếu người gọi không có quyền quản lý tất cả ứng dụng trong tài khoản. Đây cũng là true nếu người dùng này là chủ sở hữu tài khoản.

Nếu trường này là true, thì bạn nên coi đây là tín hiệu cho thấy người dùng này không thể được quản lý hoàn toàn thông qua API. Tức là người gọi API không thể quản lý tất cả các quyền mà người dùng này có, có thể là do người gọi không biết về các quyền đó hoặc do người dùng là chủ sở hữu tài khoản.

developerAccountPermissions[]

enum (DeveloperLevelPermission)

Quyền của người dùng được áp dụng trên toàn bộ tài khoản nhà phát triển.

grants[]

object (Grant)

Chỉ có đầu ra. Quyền theo từng ứng dụng cho người dùng.

AccessState

Trạng thái quyền truy cập của người dùng vào tài khoản nhà phát triển.

Enum
ACCESS_STATE_UNSPECIFIED Trạng thái truy cập không xác định hoặc chưa chỉ định.
INVITED Người dùng được mời nhưng chưa chấp nhận lời mời.
INVITATION_EXPIRED Lời mời đã hết hạn.
ACCESS_GRANTED Người dùng đã chấp nhận lời mời và có quyền truy cập vào Play Console.
ACCESS_EXPIRED Quyền truy cập vào tài khoản đã hết hạn.

DeveloperLevelPermission

Quyền được cấp ở cấp tài khoản nhà phát triển.

Enum
DEVELOPER_LEVEL_PERMISSION_UNSPECIFIED Quyền không xác định hoặc không được chỉ định.
CAN_SEE_ALL_APPS

Xem thông tin ứng dụng và tải hàng loạt báo cáo xuống (chỉ có quyền đọc). Không dùng nữa: Hãy kiểm tra CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL.

CAN_VIEW_FINANCIAL_DATA_GLOBAL Xem dữ liệu tài chính, đơn đặt hàng, cũng như phản hồi trong bản khảo sát về quyết định huỷ đăng ký.
CAN_MANAGE_PERMISSIONS_GLOBAL Quản trị viên (có tất cả quyền).
CAN_EDIT_GAMES_GLOBAL Chỉnh sửa dự án Dịch vụ trò chơi của Play.
CAN_PUBLISH_GAMES_GLOBAL Phát hành dự án Dịch vụ trò chơi của Play.
CAN_REPLY_TO_REVIEWS_GLOBAL reviews.reply to reviews.
CAN_MANAGE_PUBLIC_APKS_GLOBAL Phát hành công khai, loại trừ thiết bị và sử dụng tính năng ký ứng dụng của Google Play.
CAN_MANAGE_TRACK_APKS_GLOBAL Phát hành lên các kênh kiểm thử.
CAN_MANAGE_TRACK_USERS_GLOBAL Quản lý kênh kiểm thử và chỉnh sửa danh sách người kiểm thử.
CAN_MANAGE_PUBLIC_LISTING_GLOBAL Quản lý sự hiện diện trên Cửa hàng Play.
CAN_MANAGE_DRAFT_APPS_GLOBAL Tạo, chỉnh sửa và xoá các ứng dụng nháp.
CAN_CREATE_MANAGED_PLAY_APPS_GLOBAL Tạo và phát hành ứng dụng riêng tư cho tổ chức của bạn.
CAN_CHANGE_MANAGED_PLAY_SETTING_GLOBAL Chọn ra mắt công khai các ứng dụng hay chỉ phát hành cho tổ chức của bạn.
CAN_MANAGE_ORDERS_GLOBAL Quản lý đơn đặt hàng và gói thuê bao.
CAN_MANAGE_APP_CONTENT_GLOBAL Quản lý các trang liên quan đến chính sách trên tất cả ứng dụng của nhà phát triển.
CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL Xem thông tin ứng dụng và tải hàng loạt báo cáo xuống (chỉ có quyền đọc).
CAN_VIEW_APP_QUALITY_GLOBAL Xem thông tin về chất lượng ứng dụng cho tất cả ứng dụng của nhà phát triển.

Phương thức

create

Cấp quyền truy cập cho người dùng vào tài khoản nhà phát triển đã cho.

delete

Xoá tất cả quyền truy cập của người dùng vào tài khoản nhà phát triển đã cho.

list

Liệt kê tất cả người dùng có quyền truy cập vào một tài khoản nhà phát triển.

patch

Cập nhật quyền truy cập của người dùng vào tài khoản nhà phát triển.

Mã lỗi

Các thao tác của tài nguyên này sẽ trả về các mã lỗi HTTP sau:

Mã lỗi Lý do Độ phân giải
5xx Lỗi chung trong máy chủ Google Play. Hãy thử gửi lại yêu cầu.

Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với người quản lý tài khoản Google Play hoặc gửi yêu cầu hỗ trợ. Hãy cân nhắc kiểm tra Trang tổng quan về trạng thái của Play để xem có sự cố ngừng hoạt động nào đã biết hay không.

409 Lỗi cập nhật đồng thời.

Đã có một nỗ lực cập nhật một đối tượng đang được cập nhật. Ví dụ: giao dịch mua được xác nhận bằng cách gọi phương thức acknowledgePurchase() của Thư viện Play Billing và gọi purchases.products.acknowledge của API Nhà phát triển Play cùng một lúc.

Hãy thử gửi lại yêu cầu.