Stay organized with collections
Save and categorize content based on your preferences.
Generates a URL that can be rendered in an iframe to display the
permissions (if any) of a product. An enterprise admin must view these
permissions and accept them on behalf of their organization in order to
approve that product.
Admins should accept the displayed permissions by
interacting with a separate UI element in the EMM console, which in turn
should trigger the use of this URL as the
approvalUrlInfo.approvalUrl property in a
Products.approve call to approve the product.
This URL can only be used to display permissions for up to 1 day.
Request
HTTP request
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/products/productId/generateApprovalUrl
Parameters
Parameter name
Value
Description
Path parameters
enterpriseId
string
The ID of the enterprise.
productId
string
The ID of the product.
Optional query parameters
languageCode
string
The BCP 47 language code used for permission names and descriptions in
the returned iframe, for instance "en-US".
Authorization
This request requires authorization with the following scope:
If successful, this method returns a response body with the following structure:
{
"url": string
}
Property name
Value
Description
Notes
url
string
A URL that can be rendered in an iframe to display the permissions (if any) of a product. This URL can be used to approve the product only once and only within 24 hours of being generated, using the Products.approve call. If the product is currently unapproved and has no permissions, this URL will point to an empty page. If the product is currently approved, a URL will only be generated if that product has added permissions since it was last approved, and the URL will only display those new permissions that have not yet been accepted.
[null,null,["Last updated 2024-10-31 UTC."],[[["\u003cp\u003eGenerates a URL for an iframe to display product permissions for enterprise admin approval, accessible until September 30, 2025.\u003c/p\u003e\n"],["\u003cp\u003eAdmins approve permissions through a separate UI element, triggering a \u003ccode\u003eProducts.approve\u003c/code\u003e call with the generated URL.\u003c/p\u003e\n"],["\u003cp\u003eThe URL is valid for 24 hours and displays only new permissions added since the last approval.\u003c/p\u003e\n"],["\u003cp\u003eThis method is deprecated, new integrations should refer to recommended alternatives.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Products: generateApprovalUrl\n\n| **Note:** Requires [authorization](#auth).\n\n\u003cbr /\u003e\n\n| **Deprecated:** New integrations cannot use this method and can refer to our [new\n| recommendations](/android/work/deprecations#recommended_alternative). \n| **This method will no longer be accessible by\n| anyone after September 30, 2025.**\nGenerates a URL that can be rendered in an iframe to display the permissions (if any) of a product. An enterprise admin must view these permissions and accept them on behalf of their organization in order to approve that product. \n\nAdmins should accept the displayed permissions by interacting with a separate UI element in the EMM console, which in turn should trigger the use of this URL as the `approvalUrlInfo.approvalUrl` property in a `Products.approve` call to approve the product. This URL can only be used to display permissions for up to 1 day.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/products/productId/generateApprovalUrl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|-------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n| `productId` | `string` | The ID of the product. |\n| **Optional query parameters** |||\n| `languageCode` | `string` | The BCP 47 language code used for permission names and descriptions in the returned iframe, for instance \"en-US\". |\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 that can be rendered in an iframe to display the permissions (if any) of a product. This URL can be used to approve the product only once and only within 24 hours of being generated, using the `Products.approve` call. If the product is currently unapproved and has no permissions, this URL will point to an empty page. If the product is currently approved, a URL will only be generated if that product has added permissions since it was last approved, and the URL will only display those new permissions that have not yet been accepted. | |"]]