Users

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

リソース表記

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 管理ユーザーには設定されません。

Methods

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

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

この通話は EMM が管理するアカウントでのみ利用できます。
get
ユーザーの詳細を取得します。
getAvailableProductSet
ユーザーがアクセスが許可されている商品のセットを取得します。注: この項目は非推奨になりました。新しい統合では、この方法を使用できません。新しい推奨事項をご覧ください。
挿入
新しい EMM 管理ユーザーを作成します。

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

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

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

この通話は EMM が管理するアカウントでのみ利用できます。
setAvailableProductSet
ユーザーがアクセスできる対象商品セット(許可リスト登録済み商品)を変更します。承認済みの商品や、以前に承認された商品(承認が取り消された商品)のみをホワイトリストに登録できます。 注: この項目は非推奨になりました。新しい統合では、この方法を使用できません。新しい推奨事項をご覧ください。
update
EMM 管理ユーザーの詳細を更新します。

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