חשוב: אנחנו לא מקבלים יותר רישומים חדשים עבור Play EMM API.
מידע נוסף
Enterprises: getServiceAccount
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הפונקציה מחזירה חשבון שירות ופרטי כניסה. אפשר לשייך את חשבון השירות לארגון באמצעות קריאה ל-setAccount. חשבון השירות ייחודי לארגון ול-EMM הזה, והוא יימחק אם הקישור לארגון יבוטל. פרטי הכניסה מכילים נתוני מפתח פרטי ולא מאוחסנים בצד השרת.
אפשר להפעיל את השיטה הזו רק אחרי שמפעילים את השיטה Methods.Enroll או Methods.CompleteSignup, ולפני שמפעילים את השיטה Methods.SetAccount. במקרים אחרים, תוחזר שגיאה.
קריאות נוספות אחרי הקריאה הראשונה ייצרו קבוצה חדשה וייחודית של פרטי כניסה, ויבטלו את פרטי הכניסה שנוצרו קודם.
אחרי שמקשרים את חשבון השירות לארגון, אפשר לנהל אותו באמצעות המשאב serviceAccountKeys.
.
בקשה
בקשת HTTP
GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/serviceAccount
פרמטרים
| שם הפרמטר |
ערך |
תיאור |
| פרמטרים של נתיב |
enterpriseId |
string |
המזהה של הארגון.
|
| פרמטרים אופציונליים של שאילתות |
keyType |
string |
סוג פרטי הכניסה שיוחזר עם חשבון השירות. חובה.
הערכים הקבילים הם:
- "
googleCredentials"
- "
pkcs12"
|
אישור
הבקשה הזו דורשת הרשאה ברמת ההיקף הבאה:
| היקף |
|---|
https://www.googleapis.com/auth/androidenterprise |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
אין לספק גוף בקשה בשיטה הזו.
תשובה
אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר גוף תגובה עם המבנה הבא:
{
"kind": "androidenterprise#serviceAccount",
"name": string,
"key": serviceaccountkeys Resource
}
| שם הנכס |
ערך |
תיאור |
הערות |
name |
string |
שם החשבון של חשבון השירות, בצורת כתובת אימייל. הוקצה על ידי השרת. |
|
key |
nested object |
פרטי הכניסה שאפשר להשתמש בהם כדי לבצע אימות בתור חשבון השירות הזה. |
|
kind |
string |
|
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-03-26 (שעון UTC).
[null,null,["עדכון אחרון: 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` | | |"]]
