Users

このリソースのメソッドの一覧は、このページの最後に掲載されています。

リソース表記

ユーザー リソースは、企業に関連付けられたアカウントを表します。そのアカウントはデバイスごとに固有でも、個々のユーザー(複数デバイスで同じアカウントを使用)でも構いません。このアカウントでは、ID モデルに応じて、managed Google Play のみ、または他の Google サービスへのアクセスが許可されます。

  • Google マネージド ドメインの ID モデルでは、Google アカウント ソースへの同期が必要です(primaryEmail を使用)。
  • managed Google Play アカウントの ID モデルは、企業が必要に応じてユーザー アカウントやデバイス アカウントを動的に作成できる手段です。これらのアカウントを使用すると、managed Google Play にアクセスできます。

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}
プロパティ名 価値 説明 メモ
accountIdentifier string このユーザー用に作成する一意の識別子(「user342」や「asset#44418」など)。このプロパティに個人情報(PII)を使用しないでください。EMM の管理対象ユーザーに対しては常に設定する必要があります。Google が管理するユーザーに対しては設定されません。
accountType string このユーザーが表すアカウントのタイプ。userAccount は複数のデバイスにインストールできますが、deviceAccount は 1 つのデバイスに固有のものです。EMM の管理対象ユーザー(emmManaged)は、いずれかのタイプ(userAccountdeviceAccount)になりますが、Google の管理対象ユーザー(googleManaged)は常に userAccount です。

指定できる値は次のとおりです。
  • "deviceAccount"
  • "userAccount"
displayName string ユーザー インターフェースに表示される名前。EMM の管理対象ユーザーを作成する場合、このプロパティの設定は任意です。このプロパティを設定する場合は、組織を表す一般的な名前(「Example, Inc.」など)やお客様の名前(EMM など)を使用してください。Google が管理するユーザー アカウントでは使用されません。 書き込み可能
id string ユーザーの一意の ID。

kind string
managementType string ユーザーを管理するエンティティ。googleManaged ユーザーの場合、信頼できる情報源は Google であるため、EMM はそのユーザーの Google アカウントが存在することを確認する必要があります。emmManaged 人のユーザーについては、EMM が管理します。

指定できる値は次のとおりです。
  • "emmManaged"
  • "googleManaged"
primaryEmail string ユーザーのメインのメールアドレス(例: jsmith@example.com)。Google の管理対象ユーザーに対しては常に設定され、EMM の管理対象ユーザーに対しては設定されません。

メソッド

delete
EMM の管理対象ユーザーの削除。
generateAuthenticationToken
デバイス ポリシー クライアントが、特定の EMM 管理ユーザー アカウントをデバイスにプロビジョニングするために使用できる認証トークンを生成します。生成されたトークンは 1 回限り有効で、数分後に期限切れになります。

ユーザー 1 人あたり最大 10 台のデバイスをプロビジョニングできます。

この通話は EMM の管理対象アカウントでのみご利用いただけます。
get
ユーザーの詳細を取得します。
getAvailableProductSet
ユーザーがアクセスできるサービスのセットを取得します。
insert
EMM の管理対象ユーザーを新規作成します。

リクエストの本文で渡される Users リソースには、accountIdentifieraccountType を含める必要があります。

同じアカウント ID の対応するユーザーがすでに存在する場合、ユーザーはリソースで更新されます。この場合、変更できるのは displayName フィールドのみです。

list
メインのメールアドレスでユーザーを検索します。これは、Google の管理対象ユーザーのみが使用できます。EMM の管理対象ユーザーに対しては、Users.insert 呼び出しの結果ですでに ID が返されているため、ID の検索は必要ありません。
revokeDeviceAccess
現在ユーザーにプロビジョニングされているすべてのデバイスへのアクセス権を取り消します。ユーザーは、すべての管理対象デバイスで managed Play ストアを使用できなくなります。

この通話は EMM の管理対象アカウントでのみご利用いただけます。
setAvailableProductSet
ユーザーがアクセスできる一連のアイテム(whitelisted許可リストに登録された商品)を変更します。許可リストに登録できるのは、承認された商品または以前に承認された商品(承認が取り消された商品)のみです。
update
EMM の管理対象ユーザーの詳細を更新します。

EMM の管理対象ユーザーのみが使用できます(Google の管理対象ユーザーでは使用できません)。 リクエストの本文でユーザー リソースの新しい詳細を渡します。変更できるのは displayName フィールドのみです。他のフィールドは、未設定のままにするか、現在アクティブな値を指定する必要があります。