REST Resource: customers.configurations
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: 구성
구성은 Android 기기의 프로비저닝 옵션을 수집합니다. 모든 구성에는 아래 항목이 포함되어 있습니다.
- 기기에 설치된 EMM 기기 정책 컨트롤러 (DPC)
- 기기에 적용된 EMM 정책
- 설정 중에 사용자를 지원하기 위해 기기에 표시되는 메타데이터입니다.
고객은 필요한 만큼 구성을 추가할 수 있습니다. 하지만 제로터치 등록은 고객이 조직에서 구매하는 모든 새 기기에 적용되는 기본 구성을 설정할 때 가장 효과적입니다.
| JSON 표현 |
{
"name": string,
"configurationId": string,
"configurationName": string,
"dpcResourcePath": string,
"dpcExtras": string,
"companyName": string,
"contactEmail": string,
"contactPhone": string,
"customMessage": string,
"isDefault": boolean,
"forcedResetTime": string
} |
| 필드 |
name |
string
출력 전용입니다. customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] 형식의 API 리소스 이름입니다. 서버에서 할당됩니다.
|
configurationId |
string (int64 format)
출력 전용입니다. 구성의 ID입니다. 서버에서 할당됩니다.
|
configurationName |
string
필수 항목입니다. 구성의 목적을 설명하는 짧은 이름입니다. 예: 영업팀 또는 임시직원 제로터치 등록 포털에서 IT 관리자에게 이 이름을 표시합니다.
|
dpcResourcePath |
string
필수 항목입니다. 선택한 DPC (기기 정책 컨트롤러)의 리소스 이름으로, customers/[CUSTOMER_ID]/dpcs/* 형식입니다. 지원되는 DPC를 나열하려면 customers.dpcs.list
|
companyName |
string
필수 항목입니다. 조직의 이름입니다. 제로터치 등록은 기기 프로비저닝 중에 기기 사용자에게 이 조직 이름을 표시합니다.
|
contactEmail |
string
필수 항목입니다. 기기 사용자가 도움을 요청할 수 있는 이메일 주소입니다. 제로터치 등록에서 기기 프로비저닝을 시작하기 전에 기기 사용자에게 이 이메일 주소를 표시합니다. 값은 입력 시 검증됩니다.
|
contactPhone |
string
필수 항목입니다. 기기 사용자가 도움을 받기 위해 다른 기기를 사용하여 전화를 걸 수 있는 전화번호입니다. 제로터치 등록에서 기기 프로비저닝 전에 기기 사용자에게 이 번호를 표시합니다. 숫자, 공백, 더하기 기호, 하이픈, 괄호를 사용할 수 있습니다.
|
customMessage |
string
기기 사용자가 도움을 받거나 기기에 발생하는 문제에 대한 세부정보를 제공하는 데 도움이 되는 한두 문장으로 이루어진 메시지입니다. 제로터치 등록에서 기기 프로비저닝을 시작하기 전에 이 메시지를 표시합니다.
|
isDefault |
boolean
필수 항목입니다. 향후 조직에서 구매하는 모든 새 기기에 제로터치 등록이 적용되는 기본 구성인지 여부입니다. 하나의 고객 구성만 기본값으로 지정할 수 있습니다. 이 값을 true로 설정하면 이전 기본 구성의 isDefault 값이 false로 변경됩니다.
|
forcedResetTime |
string (Duration format)
선택사항입니다. 기기가 설정 마법사에서 프로비저닝을 진행하지 않는 경우 강제로 초기화하기 전 제한 시간이 표시됩니다. 이는 주로 설정 마법사에서 네트워크 연결이 끊긴 경우에 발생합니다. 범위는 0~6시간이며, 설정하지 않은 경우 2시간이 기본값입니다. 소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
|
메서드 |
|
|
새 구성을 만듭니다. |
|
|
사용되지 않는 구성을 삭제합니다. |
|
|
구성 세부정보를 가져옵니다. |
|
|
고객의 구성을 나열합니다. |
|
|
구성의 필드 값을 업데이트합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eA configuration combines the EMM device policy controller, enforced policies, and setup metadata for Android devices.\u003c/p\u003e\n"],["\u003cp\u003eCustomers can create multiple configurations, but setting a default configuration is recommended for newly purchased devices.\u003c/p\u003e\n"],["\u003cp\u003eEach configuration includes details like the configuration name, DPC resource path, company information, and contact details for user assistance.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of a configuration details its properties such as \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003econfigurationId\u003c/code\u003e, \u003ccode\u003econfigurationName\u003c/code\u003e, \u003ccode\u003edpcResourcePath\u003c/code\u003e, \u003ccode\u003edpcExtras\u003c/code\u003e, \u003ccode\u003ecompanyName\u003c/code\u003e, \u003ccode\u003econtactEmail\u003c/code\u003e, \u003ccode\u003econtactPhone\u003c/code\u003e, \u003ccode\u003ecustomMessage\u003c/code\u003e, \u003ccode\u003eisDefault\u003c/code\u003e, and \u003ccode\u003eforcedResetTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eMethods are available to create, delete, get, list, and update device configurations.\u003c/p\u003e\n"]]],["Configurations are used to manage Android device provisioning, combining the EMM device policy controller (DPC), EMM policies, and setup metadata. Key information includes the `configurationName`, `dpcResourcePath`, `companyName`, `contactEmail`, `contactPhone`, and `customMessage`. The `isDefault` field designates the default configuration. Methods allow to create, delete, get, list, and patch configurations. A configuration uses a `forcedResetTime` for factory reset if the device does not get provisioned.\n"],null,["# REST Resource: customers.configurations\n\n- [Resource: Configuration](#Configuration)\n - [JSON representation](#Configuration.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Configuration\n-----------------------\n\nA configuration collects the provisioning options for Android devices. Each configuration combines the following:\n\n- The EMM device policy controller (DPC) installed on the devices.\n- EMM policies enforced on the devices.\n- Metadata displayed on the device to help users during setup.\n\nCustomers can add as many configurations as they need. However, zero-touch enrollment works best when a customer sets a default configuration that's applied to any new devices the organization purchases.\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"configurationId\": string, \"configurationName\": string, \"dpcResourcePath\": string, \"dpcExtras\": string, \"companyName\": string, \"contactEmail\": string, \"contactPhone\": string, \"customMessage\": string, \"isDefault\": boolean, \"forcedResetTime\": string } ``` |\n\n| Fields ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by the server. |\n| `configurationId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The ID of the configuration. Assigned by the server. |\n| `configurationName` | `string` Required. A short name that describes the configuration's purpose. For example, *Sales team* or *Temporary employees*. The zero-touch enrollment portal displays this name to IT admins. |\n| `dpcResourcePath` | `string` Required. The resource name of the selected DPC (device policy controller) in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs, call [`customers.dpcs.list`](/zero-touch/reference/customer/rest/v1/customers.dpcs/list#google.android.device.provisioning.v1.customer.DeviceProvisioningCustomerService.ListDpcs). |\n| `dpcExtras` | `string` The JSON-formatted EMM provisioning extras that are passed to the DPC. |\n| `companyName` | `string` Required. The name of the organization. Zero-touch enrollment shows this organization name to device users during device provisioning. |\n| `contactEmail` | `string` Required. The email address that device users can contact to get help. Zero-touch enrollment shows this email address to device users before device provisioning. The value is validated on input. |\n| `contactPhone` | `string` Required. The telephone number that device users can call, using another device, to get help. Zero-touch enrollment shows this number to device users before device provisioning. Accepts numerals, spaces, the plus sign, hyphens, and parentheses. |\n| `customMessage` | `string` A message, containing one or two sentences, to help device users get help or give them more details about what's happening to their device. Zero-touch enrollment shows this message before the device is provisioned. |\n| `isDefault` | `boolean` Required. Whether this is the default configuration that zero-touch enrollment applies to any new devices the organization purchases in the future. Only one customer configuration can be the default. Setting this value to `true`, changes the previous default configuration's `isDefault` value to `false`. |\n| `forcedResetTime` | `string (`[Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration)` format)` Optional. The timeout before forcing factory reset the device if the device doesn't go through provisioning in the setup wizard, usually due to lack of network connectivity during setup wizard. Ranges from 0-6 hours, with 2 hours being the default if unset. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------|-----------------------------------------|\n| ### [create](/zero-touch/reference/customer/rest/v1/customers.configurations/create) | Creates a new configuration. |\n| ### [delete](/zero-touch/reference/customer/rest/v1/customers.configurations/delete) | Deletes an unused configuration. |\n| ### [get](/zero-touch/reference/customer/rest/v1/customers.configurations/get) | Gets the details of a configuration. |\n| ### [list](/zero-touch/reference/customer/rest/v1/customers.configurations/list) | Lists a customer's configurations. |\n| ### [patch](/zero-touch/reference/customer/rest/v1/customers.configurations/patch) | Updates a configuration's field values. |"]]
