REST Resource: enterprises

리소스: Enterprise

기업에 적용되는 구성입니다.

JSON 표현
{
  "name": string,
  "enabledNotificationTypes": [
    enum (NotificationType)
  ],
  "pubsubTopic": string,
  "primaryColor": integer,
  "logo": {
    object (ExternalData)
  },
  "enterpriseDisplayName": string,
  "termsAndConditions": [
    {
      object (TermsAndConditions)
    }
  ],
  "appAutoApprovalEnabled": boolean,
  "signinDetails": [
    {
      object (SigninDetail)
    }
  ],
  "contactInfo": {
    object (ContactInfo)
  }
}
입력란
name

string

생성 중에 서버에서 생성한 기업 이름으로 enterprises/{enterpriseId} 형식입니다.

enabledNotificationTypes[]

enum (NotificationType)

기업에 사용 설정된 Google Pub/Sub 알림 유형입니다.

pubsubTopic

string

projects/{project}/topics/{topic} 형식의 Pub/Sub 알림이 게시되는 주제입니다. 이 필드는 Pub/Sub 알림이 사용 설정된 경우에만 필요합니다.

primaryColor

integer

기기 관리 앱 UI에 표시할 주요 색상을 나타내는 RGB 형식의 색상입니다. 색상 구성요소는 (red << 16) | (green << 8) | blue로 저장됩니다. 여기서 각 구성요소의 값은 0~255(포함)입니다.

enterpriseDisplayName

string

사용자에게 표시되는 기업 이름입니다. 이 필드의 최대 길이는 100자(영문 기준)입니다.

termsAndConditions[]

object (TermsAndConditions)

이 기업에 기기를 프로비저닝할 때 동의해야 하는 이용약관입니다. 이 목록의 각 값에 대해 용어 페이지가 생성됩니다.

appAutoApprovalEnabled
(deprecated)

boolean

지원 중단되었으며 사용되지 않습니다.

signinDetails[]

object (SigninDetail)

기업의 로그인 세부정보입니다.

contactInfo

object (ContactInfo)

EMM 관리 기업의 기업 연락처 정보입니다.

NotificationType

기기 관리 서버에서 Google Pub/Sub를 통해 전송할 수 있는 알림 유형입니다.

열거형
NOTIFICATION_TYPE_UNSPECIFIED 이 값은 무시됩니다.
ENROLLMENT 기기가 등록될 때 전송되는 알림
COMPLIANCE_REPORT

지원이 중단되었습니다.

STATUS_REPORT 기기에서 상태 보고서를 발행하면 전송되는 알림입니다.
COMMAND 기기 명령어가 완료되면 전송되는 알림입니다.
USAGE_LOGS 기기에서 BatchUsageLogEvents를 전송하면 알림이 전송됩니다.

ExternalData

외부 위치에서 호스팅되는 데이터 데이터는 Android Device Policy를 통해 다운로드되고 해시에 대해 확인됩니다.

JSON 표현
{
  "url": string,
  "sha256Hash": string
}
입력란
url

string

데이터의 절대 URL로, http 또는 https 스키마를 사용해야 합니다. Android Device Policy는 GET 요청에서 사용자 인증 정보를 제공하지 않으므로 URL에 공개적으로 액세스할 수 있어야 합니다. URL에 길고 임의의 구성요소를 포함하면 공격자가 URL을 발견하지 못하게 할 수 있습니다.

sha256Hash

string

URL에서 호스팅되는 콘텐츠의 base-64로 인코딩된 SHA-256 해시입니다. 콘텐츠가 이 해시와 일치하지 않으면 Android Device Policy에서 데이터를 사용하지 않습니다.

TermsAndConditions

프로비저닝 중에 동의해야 하는 이용약관 페이지

JSON 표현
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
입력란
header

object (UserFacingMessage)

HTML 콘텐츠 위에 표시되는 짧은 헤더입니다.

content

object (UserFacingMessage)

올바른 형식의 HTML 문자열. android.text.HTML#fromHTML을 사용하여 클라이언트에서 파싱됩니다.

SigninDetail

기업의 로그인 세부정보가 포함된 리소스입니다. enterprises를 사용하여 특정 기업의 SigninDetail를 관리합니다.

기업의 경우 다음 3개의 필드 (signinUrl, allowPersonalUsage, tokenTag)의 조합으로 고유하게 식별되는 SigninDetail를 원하는 만큼 보유할 수 있습니다. 동일한 필드 (signinUrl, allowPersonalUsage, tokenTag)로 두 개의 SigninDetail를 만들 수는 없습니다(tokenTag는 선택 필드).

Patch: 이 작업은 현재 SigninDetails 목록을 새 SigninDetails 목록으로 업데이트합니다.

  • 저장된 SigninDetail 구성이 전달되면 동일한 signinEnrollmentTokenqrCode가 반환됩니다.
  • 저장되지 않은 동일한 SigninDetail 구성을 여러 개 전달하면 SigninDetail 구성 중 첫 번째 구성을 저장합니다.
  • 구성이 이미 존재하는 경우 특정 패치 API 호출에서 두 번 이상 요청할 수 없습니다. 그렇지 않으면 중복 키 오류가 발생하고 전체 작업이 실패합니다.
  • 요청에서 특정 SigninDetail 구성을 삭제하면 스토리지에서 삭제됩니다. 그런 다음 동일한 SigninDetail 구성에 대해 다른 signinEnrollmentTokenqrCode를 요청할 수 있습니다.
JSON 표현
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "tokenTag": string
}
입력란
signinUrl

string

기기가 로그인 등록 토큰으로 프로비저닝된 경우 인증을 위한 로그인 URL입니다. 로그인 엔드포인트에서 로그인에 성공하려면 https://enterprise.google.com/android/enroll?et= 형식의 URL을, 또는 실패한 로그인의 경우 https://enterprise.google.com/android/enroll/invalid 형식의 URL을 사용하여 인증 흐름을 완료해야 합니다.

signinEnrollmentToken

string

커스텀 로그인 흐름을 트리거하는 데 사용되는 전사적 등록 토큰입니다. 이것은 서버에서 생성한 읽기 전용 입력란입니다.

qrCode

string

이 등록 토큰으로 기기를 등록하기 위해 QR 코드를 생성하는 데 사용할 수 있는 UTF-8 표현을 사용하는 JSON 문자열입니다. NFC를 사용하여 기기를 등록하려면 NFC 기록에 JSON으로 된 속성의 직렬화된 java.util.Properties 표현이 포함되어야 합니다. 이것은 서버에서 생성한 읽기 전용 입력란입니다.

allowPersonalUsage

enum (AllowPersonalUsage)

이 등록 토큰으로 프로비저닝된 기기에서 개인 사용을 허용할지 여부를 제어합니다.

회사 소유 기기의 경우:

  • 개인 용도로 사용 설정하면 사용자가 기기에 직장 프로필을 설정할 수 있습니다.
  • 개인 사용을 중지하려면 사용자가 기기를 완전 관리형 기기로 프로비저닝해야 합니다.

개인 소유 기기의 경우:

  • 개인 용도로 사용 설정하면 사용자가 기기에 직장 프로필을 설정할 수 있습니다.
  • 개인 사용을 중지하면 기기에서 프로비저닝할 수 없습니다. 개인 소유 기기에서는 개인 사용을 중지할 수 없습니다.
tokenTag

string

SigninDetail 인스턴스를 구별하기 위해 EMM에서 지정한 메타데이터입니다.

ContactInfo

기업용 관리 Google Play의 연락처 세부정보입니다.

JSON 표현
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
입력란
contactEmail

string

담당자 이메일 주소로, Managed Google Play와 관련된 중요 공지사항을 전송하는 데 사용됩니다.

dataProtectionOfficerName

string

데이터 보호 책임자의 이름입니다.

dataProtectionOfficerEmail

string

데이터 보호 담당자의 이메일입니다. 이메일은 확인되었지만 확인되지 않았습니다.

dataProtectionOfficerPhone

string

데이터 보호 담당자의 전화번호입니다. 전화번호는 검증되었지만 확인되지 않았습니다.

euRepresentativeName

string

EU 담당자의 이름입니다.

euRepresentativeEmail

string

EU 담당자의 이메일. 이메일은 확인되었지만 확인되지 않았습니다.

euRepresentativePhone

string

EU 담당자의 전화번호 전화번호가 확인되었으나 확인되지 않았습니다.

방법

create

엔터프라이즈를 만듭니다.

delete

기업 및 기업에 연결된 모든 계정 및 데이터를 영구적으로 삭제합니다.

get

엔터프라이즈를 가져옵니다.

list

EMM 관리 기업을 나열합니다.

patch

엔터프라이즈를 업데이트합니다.