Enterprises

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

Enterprises 리소스는 EMM과 특정 조직 간의 바인딩을 나타냅니다. 이 바인딩은 다음과 같이 이 API를 사용하여 두 가지 방법 중 하나로 인스턴스화할 수 있습니다.

Google 관리 도메인 고객의 경우 Enterprises.enroll 및 Enterprises.setAccount (관리 콘솔 및 Google API 콘솔에서 얻은 아티팩트와 함께)를 사용하여 거의 수동 프로세스를 통해 EMM에 제출하는 과정이 프로세스에 포함됩니다.
관리 Google Play 계정 고객의 경우 Enterprises.generateSignupUrl 및 Enterprises.completeSignup를 관리 Google Play 가입 UI (Google에서 제공하는 메커니즘)와 함께 사용하여 수동 단계 없이 결합을 생성하는 과정이 포함됩니다.

EMM은 EMM 콘솔에서 두 가지 접근 방식 중 하나 또는 둘 다를 지원할 수 있습니다. 자세한 내용은 엔터프라이즈 만들기를 참고하세요.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ]
}

속성 이름	값	설명
`administrator[]`	`list`	기업의 관리자입니다. 이는 EMM에서 시작된 절차를 통해 만든 기업에만 지원됩니다.
`administrator[].email`	`string`	관리자의 이메일 주소입니다.
`id`	`string`	기업의 고유 ID입니다.
`kind`	`string`
`name`	`string`	기업 이름입니다(예: 'Example, Inc').
`primaryDomain`	`string`	기업의 기본 도메인(예: 'example.com')

방법

acknowledgeNotificationSet: 후속 호출이 동일한 알림을 반환하지 않도록 Enterprises.PullNotificationSet에서 수신한 알림을 확인합니다.
completeSignup: 완료 토큰과 엔터프라이즈 토큰을 지정하여 가입 과정을 완료합니다. 특정 엔터프라이즈 토큰에 대해 이 요청을 여러 번 호출하면 안 됩니다.
createWebToken: 삽입 가능한 UI에 액세스하기 위한 고유 토큰을 반환합니다. 웹 UI를 생성하려면 생성된 토큰을 관리 Google Play JavaScript API에 전달합니다. 각 토큰은 하나의 UI 세션을 시작하는 데만 사용할 수 있습니다. 자세한 내용은 JavaScript API 문서를 참고하세요.
등록: 통화 EMM에 기업을 등록합니다.
generateSignupUrl: 가입 URL을 생성합니다.
get: 기업의 이름과 도메인을 검색합니다.
getServiceAccount: 서비스 계정과 사용자 인증 정보를 반환합니다. 서비스 계정은 setAccount를 호출하여 기업에 바인딩될 수 있습니다. 서비스 계정은 이 기업과 EMM에 고유하며 기업이 바인딩 해제되면 삭제됩니다. 사용자 인증 정보는 비공개 키 데이터를 포함하며 서버 측에 저장되지 않습니다.

이 메서드는 Enterprises.Enroll 또는 Enterprises.CompleteSignup을 호출한 후 Enterprises.SetAccount 전에만 호출할 수 있으며 그 외에는 오류를 반환합니다.

첫 번째 호출 이후의 후속 호출은 새로운 고유한 사용자 인증 정보 세트를 생성하고 이전에 생성된 사용자 인증 정보를 무효화합니다.

서비스 계정이 기업에 결합되면 serviceAccountKeys 리소스를 사용하여 관리할 수 있습니다.
getStoreLayout: 기업의 매장 레이아웃을 반환합니다. 스토어 레이아웃이 설정되지 않은 경우 스토어 레이아웃 유형으로 'basic'을 반환하고 홈페이지는 반환하지 않습니다.
list: 도메인 이름으로 기업을 조회합니다. 이는 Google에서 시작한 만들기 과정을 통해 만든 기업에만 지원됩니다. EMM에서 시작된 흐름을 통해 만든 기업의 경우 Enterprises.generateSignupUrl 호출에 지정된 콜백에서 엔터프라이즈 ID를 학습하므로 ID를 조회할 필요가 없습니다.
pullNotificationSet: 요청에 대해 인증된 서비스 계정과 연결된 기업에 대한 알림 집합을 가져와서 반환합니다. 대기 중인 알림이 없으면 알림 집합이 비어 있을 수 있습니다.
반환된 알림 세트는 알림 세트가 비어 있지 않은 한 Enterprises.AcknowledgeNotificationSet을 호출하여 20초 이내에 확인해야 합니다.
20초 이내에 확인되지 않은 알림은 결국 또 다른 PullNotificationSet 요청에 대한 응답에 다시 포함되고, 확인되지 않은 알림은 최종적으로 Google Cloud Platform Pub/Sub 시스템 정책에 따라 삭제됩니다.
알림 검색을 위해 여러 요청이 동시에 실행될 수 있습니다. 이 경우 대기 중인 알림 (있는 경우)이 대기 중인 경우 각 호출자 간에 분할됩니다.
알림이 없으면 빈 알림 목록이 반환됩니다. 후속 요청에서 알림을 사용할 수 있게 되면 더 많은 알림을 반환할 수 있습니다.
sendTestPushNotification: 테스트 알림을 전송하여 이 기업의 Google Cloud Pub/Sub 서비스와 EMM이 통합되었는지 확인합니다.
setAccount: API에 인증하는 데 사용할 계정을 엔터프라이즈로 설정합니다.
setStoreLayout: 기업의 매장 레이아웃을 설정합니다. 기본적으로 storeLayoutType은 'basic'으로 설정되고 기본 스토어 레이아웃이 사용 설정됩니다. 기본 레이아웃에는 관리자가 승인하고 사용자에게 사용 가능한 제품 세트에 추가된 앱만 포함됩니다 ( setAvailableProductSet 호출 사용). 페이지의 앱은 제품 ID 값에 따라 정렬됩니다. 맞춤 스토어 레이아웃을 만들면 (storeLayoutType = 'custom'을 설정하고 홈페이지를 설정) 기본 스토어 레이아웃이 사용 중지됩니다.
등록 해제: 호출 EMM에서 기업을 등록 해제합니다.