重要: Play EMM API の新しい登録受け付けは終了しました。
詳細
Enterprises: generateSignupUrl
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
登録 URL を生成します。
リクエスト
HTTP リクエスト
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
パラメータ
パラメータ名 |
値 |
説明 |
省略可能なクエリ パラメータ |
adminEmail |
string |
省略可。エンタープライズ登録フォームの管理者フィールドに事前入力するために使用されるメールアドレス。この値はヒントのみであり、ユーザーが変更できます。「allowedDomains」が空でない場合、これは「allowedDomains」のいずれかに属している必要があります。
|
allowedDomains |
string |
省略可。管理者メールに許可されるドメインのリスト。IT 管理者は、このリストにないドメイン名のメールアドレスを入力できません。このリストに含まれるドメインのサブドメインは許可されませんが、ドメイン名の前に「*.」が付いた 2 つ目のエントリを追加することで許可できます(例: *.example.com)。このフィールドが存在しない場合、または空のリストである場合、IT 管理者は任意の有効なドメイン名を使用できます。個人用メールドメインは常に使用できますが、managed Google Play アカウント エンタープライズが作成されます。
|
callbackUrl |
string |
エンタープライズの作成に成功した後に管理者がリダイレクトされるコールバック URL。リダイレクトする前に、この URL に「enterpriseToken」という名前の単一のクエリ パラメータが追加されます。このパラメータには、CompleteSignup リクエストに使用される不透明トークンが含まれます。
URL が解析され、パラメータが追加され、新しい URL がフォーマットされます。つまり、フォーマットが若干変更される可能性があります。また、解析できるように URL が適切に形式化されている必要があります。
|
承認
このリクエストには、次のスコープによる認証が必要です。
スコープ |
https://www.googleapis.com/auth/androidenterprise |
詳しくは、認証と認可のページをご覧ください。
リクエストの本文
このメソッドをリクエストの本文に含めないでください。
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{
"kind": string,
"url": string,
"completionToken": string
}
プロパティ名 |
値 |
説明 |
メモ |
url |
string |
管理者が企業に登録できる URL。参照先のページを iframe でレンダリングできない。 |
|
completionToken |
string |
不透明なトークン。CompleteSignup からエンタープライズ リソースを取得するために、エンタープライズ トークンと併用する必要があります。 |
|
kind |
string |
非推奨。
|
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-03-27 UTC。
[null,null,["最終更新日 2025-03-27 UTC。"],[[["\u003cp\u003eGenerates a sign-up URL for Android enterprise enrollment using the \u003ccode\u003esignupUrl\u003c/code\u003e endpoint with an optional admin email and callback URL.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful signup, a response provides a sign-up URL for the admin and a completion token for finalizing the process with the \u003ccode\u003eCompleteSignup\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary to use this endpoint.\u003c/p\u003e\n"]]],[],null,["# Enterprises: generateSignupUrl\n\n| **Note:** Requires [authorization](#auth).\n\nGenerates a sign-up URL.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Optional query parameters** |||\n| `adminEmail` | `string` | Optional. Email address used to prefill the admin field of the enterprise signup form. This value is a hint only and can be altered by the user. 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 always allowed, but will result in the creation of a managed Google Play Accounts enterprise. |\n| `callbackUrl` | `string` | The callback URL to which the Admin will be redirected after successfully creating an enterprise. Before redirecting there the system will add a single query parameter to this URL named \"enterpriseToken\" which will contain an opaque token to be used for the CompleteSignup request. Beware that this means that the URL will be parsed, the parameter added and then a new URL formatted, i.e. there may be some minor formatting changes and, more importantly, the URL must be well-formed so that it can be parsed. |\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 \"kind\": string,\n \"url\": string,\n \"completionToken\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `url` | `string` | A URL under which the Admin can sign up for an enterprise. The page pointed to cannot be rendered in an iframe. | |\n| `completionToken` | `string` | An opaque token that will be required, along with the Enterprise Token, for obtaining the enterprise resource from CompleteSignup. | |\n| `kind` | `string` | Deprecated. | |"]]