重要: Play EMM API の新しい登録受け付けは終了しました。
詳細
Enterprises: generateEnterpriseUpgradeUrl
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
既存の managed Google Play アカウント エンタープライズを Managed Google Domains にアップグレードするためのエンタープライズ アップグレード URL を生成します。詳しくは、
エンタープライズ アップグレード ガイドをご覧ください。
リクエスト
HTTP リクエスト
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/generateEnterpriseUpgradeUrl
パラメータ
パラメータ名 |
値 |
説明 |
パスパラメータ |
enterpriseId |
string |
エンタープライズの ID。
|
省略可能なクエリ パラメータ |
adminEmail |
string |
省略可。アップグレード プロセスの一部として、エンタープライズ登録フォームの管理者フィールドに事前入力するために使用されるメールアドレス。この値はヒントのみであり、ユーザーが変更できます。個人のメールアドレスは使用できません。「allowedDomains」が空でない場合、これは「allowedDomains」のいずれかに属している必要があります。
|
allowedDomains |
string |
省略可。管理者メールに許可されるドメインのリスト。IT 管理者は、このリストにないドメイン名のメールアドレスを入力できません。このリストに含まれるドメインのサブドメインは許可されませんが、ドメイン名の前に「*.」が付いた 2 つ目のエントリを追加することで許可できます(例: *.example.com)。このフィールドが存在しない場合、または空のリストである場合、IT 管理者は任意の有効なドメイン名を使用できます。個人のメールドメインは使用できません。
|
承認
このリクエストには、次のスコープによる認証が必要です。
スコープ |
https://www.googleapis.com/auth/androidenterprise |
詳しくは、認証と認可のページをご覧ください。
リクエストの本文
このメソッドをリクエストの本文に含めないでください。
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{
"url": string
}
プロパティ名 |
値 |
説明 |
メモ |
url |
string |
エンタープライズ管理者がエンタープライズをアップグレードするための URL。ページを iframe でレンダリングできない。 |
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-06-10 UTC。
[null,null,["最終更新日 2025-06-10 UTC。"],[],[],null,["# Enterprises: generateEnterpriseUpgradeUrl\n\n| **Note:** Requires [authorization](#auth).\n\nGenerates an enterprise upgrade URL to upgrade an existing managed Google\nPlay Accounts enterprise to a managed Google domain.\nSee [the guide to upgrading an enterprise](/android/work/play/emm-api/upgrade-an-enterprise) for more details.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/generateEnterpriseUpgradeUrl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|------------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n| **Optional query parameters** |||\n| `adminEmail` | `string` | Optional. Email address used to prefill the admin field of the enterprise signup form as part of the upgrade process. This value is a hint only and can be altered by the user. Personal email addresses are not allowed. If \\`allowedDomains\\` is non-empty then this must belong to one of the \\`allowedDomains\\`. |\n| `allowedDomains` | `string` | Optional. A list of domains that are permitted for the admin email. The IT admin cannot enter an email address with a domain name that is not in this list. Subdomains of domains in this list are not allowed but can be allowed by adding a second entry which has \\`\\*.\\` prefixed to the domain name (e.g. \\*.example.com). If the field is not present or is an empty list then the IT admin is free to use any valid domain name. Personal email domains are not allowed. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"url\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------|-------|\n| `url` | `string` | A URL for an enterprise admin to upgrade their enterprise. The page can't be rendered in an iframe. | |"]]