Enterprises

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

리소스 표현

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

  • Google 관리 도메인 고객의 경우 이 프로세스에는 Enterprises.enroll 및 Enterprises.setAccount를 (관리 콘솔 및 Google API 콘솔에서 가져온 아티팩트와 함께) 사용하고 어느 정도 수동 프로세스를 통해 EMM에 제출하는 것이 포함됩니다.
  • 관리 Google Play 계정 고객의 경우 이 프로세스에는 관리 Google Play 가입 UI (Google 제공 메커니즘)와 함께 Enterprises.generateSignupUrl 및 Enterprises.completeSignup를 사용하여 수동 단계 없이 결합을 만드는 작업이 포함됩니다.
EMM은 EMM 콘솔에서 두 가지 접근 방식 중 하나 또는 둘 다를 지원할 수 있습니다. 자세한 내용은 엔터프라이즈 만들기를 참고하세요. 

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "enterpriseType": string,
  "managedGoogleDomainType": string
}
속성 이름 값 설명 참고
administrator[] list 기업 관리자 이는 EMM에서 시작한 흐름을 통해 생성된 기업에만 지원됩니다.

administrator[].email string 관리자의 이메일 주소입니다.
enterpriseType string 기업 유형입니다.

허용되는 값은 다음과 같습니다.
  • "enterpriseTypeUnspecified"
  • "managedGoogleDomain"
  • "managedGooglePlayAccountsEnterprise"
id string 기업의 고유 ID입니다.

kind string
managedGoogleDomainType string 관리 Google 도메인 유형입니다.

허용되는 값은 다음과 같습니다.
  • "managedGoogleDomainTypeUnspecified"
  • "typeDomain"
  • "typeTeam"
name string 기업 이름입니다(예: 'Example, Inc').
primaryDomain string 'example.com'과 같은 기업의 기본 도메인입니다.

메서드

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

이 메서드는 Enterprises.Enroll 또는 Enterprises.CompleteSignup을 호출한 후, Enterprises.SetAccount를 호출하기 전에만 호출할 수 있습니다. 그 외의 경우에는 오류를 반환합니다.

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

서비스 계정이 기업에 연결되면 serviceAccountKeys 리소스를 사용하여 관리할 수 있습니다.

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