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

Pub/Sub 通知がパブリッシュされるトピック（projects/{project}/topics/{topic} 形式）。このフィールドは、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 でホストされているコンテンツの Base64 エンコード 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 を 2 つ作成することはできません（tokenTag はオプションのフィールドです）。

Patch: このオペレーションは、SigninDetails の現在のリストを SigninDetails の新しいリストで更新します。

  • 保存されている SigninDetail 構成が渡された場合は、同じ signinEnrollmentToken と qrCode を返します。
  • 格納されていない同一の SigninDetail 構成を複数渡した場合、それらの SigninDetail 構成のうち最初のものが保存されます。
  • 構成がすでに存在する場合は、1 回のパッチ API 呼び出しで複数回リクエストすることはできません。同じ構成を指定しないと、重複キーエラーが発生し、操作全体が失敗します。
  • リクエストから特定の SigninDetail 構成を削除すると、ストレージから削除されます。その後、同じ SigninDetail 構成に対してもう一度 signinEnrollmentToken と qrCode をリクエストできます。
JSON 表現 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "tokenTag": string
}
フィールド
signinUrl

string

ログイン登録トークンでデバイスがプロビジョニングされたときの認証用のログイン URL。ログイン エンドポイントは、ログインが成功した場合は https://enterprise.google.com/android/enroll?et= 、ログインに失敗した場合は https://enterprise.google.com/android/enroll/invalid という形式の URL で認証フローを終了する必要があります。
signinEnrollmentToken

string

カスタム ログインフローをトリガーするために使用される企業全体の登録トークン。サーバーによって生成される読み取り専用フィールドです。
qrCode

string

UTF-8 表現を使用して、この登録トークンでデバイスを登録するための QR コードを生成する JSON 文字列。NFC を使用してデバイスを登録するには、NFC レコードに、JSON のプロパティをシリアル化した java.util.Properties 表現が含まれている必要があります。サーバーによって生成される読み取り専用フィールドです。
allowPersonalUsage

enum (AllowPersonalUsage)

この登録トークンでプロビジョニングされたデバイスで、個人使用を許可するかどうかを指定します。

会社所有デバイスの場合:

  • 個人使用を有効にすると、ユーザーはデバイスに仕事用プロファイルをセットアップできます。
  • 個人使用を無効にするには、ユーザーがデバイスを完全管理対象デバイスとしてプロビジョニングする必要があります。

個人所有デバイスの場合:

  • 個人使用を有効にすると、ユーザーはデバイスに仕事用プロファイルをセットアップできます。
  • 個人での使用を無効にすると、デバイスをプロビジョニングできなくなります。個人所有のデバイスでは、個人使用を無効にできません。
tokenTag

string

SigninDetail のインスタンスを区別するための EMM 指定のメタデータ。

ContactInfo

managed 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 担当者の電話番号。電話番号は確認されましたが、確認されていません。

Methods

create

 エンタープライズを作成します。

delete

 企業と、それに関連付けられているすべてのアカウントとデータを完全に削除します。

get

 エンタープライズを取得します。

list

 EMM の管理対象企業を一覧表示します。

patch

 企業を更新します。