Lưu ý quan trọng: Chúng tôi không còn chấp nhận các lượt đăng ký mới cho Play EMM API.
Tìm hiểu thêm.
Enterprises: getServiceAccount
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trả về một tài khoản dịch vụ và thông tin xác thực. Bạn có thể liên kết tài khoản dịch vụ với doanh nghiệp bằng cách gọi setAccount. Tài khoản dịch vụ là duy nhất cho doanh nghiệp và EMM này, đồng thời sẽ bị xoá nếu doanh nghiệp bị huỷ liên kết. Thông tin xác thực chứa dữ liệu khoá riêng tư và không được lưu trữ ở phía máy chủ.
Bạn chỉ có thể gọi phương thức này sau khi gọi
Enterprises.Enroll hoặc Enterprises.CompleteSignup và trước khi gọi
Enterprises.SetAccount; nếu không, phương thức này sẽ trả về lỗi.
Các lệnh gọi tiếp theo sau lệnh gọi đầu tiên sẽ tạo một bộ thông tin xác thực mới, duy nhất và vô hiệu hoá thông tin xác thực đã tạo trước đó.
Sau khi liên kết tài khoản dịch vụ với doanh nghiệp, bạn có thể quản lý tài khoản dịch vụ đó bằng cách sử dụng tài nguyên serviceAccountKeys.
.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/serviceAccount
Thông số
| Tên thông số |
Giá trị |
Mô tả |
| Thông số đường dẫn |
enterpriseId |
string |
Mã nhận dạng của doanh nghiệp.
|
| Thông số truy vấn không bắt buộc |
keyType |
string |
Loại thông tin xác thực cần trả về cùng với tài khoản dịch vụ. Bắt buộc.
Các giá trị được chấp nhận là:
- "
googleCredentials"
- "
pkcs12"
|
Ủy quyền
Yêu cầu này yêu cầu uỷ quyền với phạm vi sau:
| Phạm vi |
|---|
https://www.googleapis.com/auth/androidenterprise |
Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.
Nội dung yêu cầu
Không cung cấp nội dung yêu cầu bằng phương thức này.
Phản hồi
Nếu thành công, phương thức này sẽ trả về một phần nội dung phản hồi có cấu trúc sau:
{
"kind": "androidenterprise#serviceAccount",
"name": string,
"key": serviceaccountkeys Resource
}
| Tên tài sản |
Giá trị |
Mô tả |
Ghi chú |
name |
string |
Tên tài khoản của tài khoản dịch vụ, ở dạng địa chỉ email. Do máy chủ chỉ định. |
|
key |
nested object |
Thông tin xác thực có thể dùng để xác thực dưới dạng Tài khoản dịch vụ này. |
|
kind |
string |
|
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-03-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-03-26 UTC."],[[["\u003cp\u003eGenerates a service account and credentials that are unique to the enterprise and EMM and can be used for authentication.\u003c/p\u003e\n"],["\u003cp\u003eThe service account can be bound to the enterprise using the \u003ccode\u003esetAccount\u003c/code\u003e call and managed with the \u003ccode\u003eserviceAccountKeys\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eRequires prior enrollment or signup completion and executing this method invalidates previously generated credentials, issuing new ones.\u003c/p\u003e\n"],["\u003cp\u003eOnly specific key types (\u003ccode\u003egoogleCredentials\u003c/code\u003e or \u003ccode\u003epkcs12\u003c/code\u003e) are supported when requesting the service account.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary for this request.\u003c/p\u003e\n"]]],[],null,["# Enterprises: getServiceAccount\n\n| **Note:** Requires [authorization](#auth).\n\nReturns a service account and credentials. The service account\ncan be bound to the enterprise by calling setAccount. The service account\nis unique to this enterprise and EMM, and will be deleted if the enterprise\nis unbound. The credentials contain private key data and are not stored\nserver-side.\n\n\u003cbr /\u003e\n\n\nThis method can only be called after calling\nEnterprises.Enroll or Enterprises.CompleteSignup, and before\nEnterprises.SetAccount; at other times it will return an error.\n\n\u003cbr /\u003e\n\n\nSubsequent calls after the first will generate a new, unique set of\ncredentials, and invalidate the previously generated credentials.\n\n\u003cbr /\u003e\n\n\nOnce the service account is bound to the enterprise, it can be managed\nusing the serviceAccountKeys resource.\n\n\u003cbr /\u003e\n\n\n\u003cbr /\u003e\n\n| **Note:** After you create a key, you might need to wait for 60 seconds or more before you perform another operation with the key. If you try to perform an operation with the key immediately after you create the key, and you receive an error, you can [retry\n| the request with exponential backoff](https://cloud.google.com/iam/docs/retry-strategy)\n\n\u003cbr /\u003e\n\n.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/serviceAccount\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n| **Optional query parameters** |||\n| `keyType` | `string` | The type of credential to return with the service account. Required. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`googleCredentials`\" - \"`pkcs12`\" |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#serviceAccount\",\n \"name\": string,\n \"key\": serviceaccountkeys Resource\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|-----------------|---------------------------------------------------------------------------------------------------|-------|\n| `name` | `string` | The account name of the service account, in the form of an email address. Assigned by the server. | |\n| `key` | `nested object` | Credentials that can be used to authenticate as this ServiceAccount. | |\n| `kind` | `string` | | |"]]
