Enterprises

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

리소스 표현

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
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}
속성 이름 값 설명 참고
administrator[] list 기업의 관리자입니다. 이는 EMM에서 시작한 흐름을 통해 생성된 기업에서만 지원됩니다.

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

허용되는 값은 다음과 같습니다.
  • "enterpriseTypeUnspecified"
  • "managedGoogleDomain"
  • "managedGooglePlayAccountsEnterprise"
googleAuthenticationSettings nested object Google 제공 사용자 인증 설정입니다.
googleAuthenticationSettings.createdAt nested object 설정이 처음 생성되거나 수정된 시간의 타임스탬프입니다.
googleAuthenticationSettings.createdAt.nanos integer 나노초 단위의 음수가 아닌 초수입니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 범위는 0~999,999,999(포함)이어야 합니다.
googleAuthenticationSettings.createdAt.seconds long Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. 범위는 0001-01-01T00:00:00Z~9999-12-31T23:59:59Z(포함)이어야 합니다.
googleAuthenticationSettings.dedicatedDevicesAllowed string 전용 기기가 허용되는지 여부입니다.

허용되는 값은 다음과 같습니다.
  • "allowed"
  • "dedicatedDevicesAllowedUnspecified"
  • "disallowed"
googleAuthenticationSettings.googleAuthenticationRequired string Google 인증이 필요한지 여부입니다.

허용되는 값은 다음과 같습니다.
  • "googleAuthenticationRequiredUnspecified"
  • "notRequired"
  • "required"
googleAuthenticationSettings.updatedAt nested object 설정이 마지막으로 수정된 시간의 타임스탬프입니다.
googleAuthenticationSettings.updatedAt.nanos integer 나노초 단위의 음수가 아닌 초수입니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 범위는 0~999,999,999(포함)이어야 합니다.
googleAuthenticationSettings.updatedAt.seconds long Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. 범위는 0001-01-01T00:00:00Z~9999-12-31T23:59:59Z(포함)이어야 합니다.
id string 기업의 고유 ID입니다.

id string 기업의 고유 ID입니다.

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

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

메서드

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

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

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

서비스 계정이 엔터프라이즈에 바인드되면 serviceAccountKeys 리소스를 사용하여 관리할 수 있습니다.

.
getStoreLayout
엔터프라이즈의 매장 레이아웃을 반환합니다. 스토어 레이아웃이 설정되지 않은 경우 스토어 레이아웃 유형으로 '기본'을 반환하고 홈페이지는 반환하지 않습니다.
list
도메인 이름으로 기업을 조회합니다. 이는 Google에서 시작한 생성 흐름을 통해 생성된 기업에만 지원됩니다. EMM이 Enterprises.generateSignupUrl 호출에 지정된 콜백에서 기업 ID를 학습하므로 EMM에서 시작된 흐름을 통해 생성된 기업에는 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에서 기업을 등록 해제합니다.