REST Resource: customers.configurations

リソース: Configuration

設定では、Android デバイスのプロビジョニング オプションが収集されます。各設定の構成は次のとおりです。

  • デバイスにインストールされている EMM Device Policy Controller（DPC）。
  • デバイスに適用される EMM ポリシー。
  • セットアップ時にユーザーをサポートするためにデバイスに表示するメタデータ。

必要な数の設定を追加できます。ゼロタッチ登録では、デフォルトの設定を作成し、その設定を組織が新規購入するすべてのデバイスに適用することをおすすめします。

JSON 表現 
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
フィールド
name

string

出力のみ。customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] 形式の API リソース名。サーバーによって割り当てられます。
configurationId

string (int64 format)

出力のみ。構成の ID。サーバーによって割り当てられます。
configurationName

string

必須。構成の目的を表す短い名前。（例: 営業チーム、臨時従業員）。ゼロタッチ登録ポータルでは、この名前が IT 管理者に表示されます。
dpcResourcePath

string

必須。選択した DPC（Device Policy Controller）のリソース名。customers/[CUSTOMER_ID]/dpcs/* の形式で指定します。サポートされている DPC を一覧表示するには、customers.dpcs.list を呼び出します。
dpcExtras

string

DPC に渡される JSON 形式の EMM プロビジョニング エクストラ。
companyName

string

必須。組織の名前。ゼロタッチ登録では、デバイスのプロビジョニング中にデバイス ユーザーにこの組織名が表示されます。
contactEmail

string

必須。デバイスのユーザーが問い合わせできるメールアドレス。ゼロタッチ登録では、端末のプロビジョニング前に端末のユーザーにこのメールアドレスが表示されます。この値は入力時に検証されます。
contactPhone

string

必須。デバイスのユーザーが別のデバイスを使用してヘルプを参照できる電話番号。ゼロタッチ登録では、デバイスのプロビジョニング前にデバイスのユーザーにこの電話番号が表示されます。数字、スペース、プラス記号、ハイフン、かっこを使用できます。
customMessage

string

1 つか 2 つの文を含むメッセージで、デバイス ユーザーがヘルプを参照したり、デバイスの動作に関する詳しい情報を提供したりするのに役立ちます。ゼロタッチ登録では、デバイスのプロビジョニング前にこのメッセージが表示されます。
isDefault

boolean

必須。組織が今後購入する新しいデバイスにゼロタッチ登録に適用されるデフォルトの設定かどうか。デフォルトとして設定できる顧客設定は 1 つのみです。この値を true に設定すると、以前のデフォルト構成の isDefault 値が false に変更されます。
forcedResetTime

string (Duration format)

（省略可）セットアップ ウィザードでデバイスがプロビジョニングされなかった場合（通常はセットアップ ウィザード中にネットワーク接続が行われなかった場合）、デバイスを強制的に出荷時設定にリセットするまでのタイムアウト。0 ～ 6 時間の範囲で設定されます。設定しなかった場合は、デフォルトの 2 時間が使用されます。

小数点以下 9 桁以下で指定し、末尾が「s」で終わる秒数。例: "3.5s"。

Methods

create

 新しい構成を作成します。

delete

 未使用の構成を削除します。

get

 構成の詳細を取得します。

list

 顧客の構成を一覧表示します。

patch

 構成のフィールドの値を更新します。