blob: 14c4e33387bdb2cae037a494606428f076328959 [file] [log] [blame]
{
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/apps.licensing": {
"description": "View and manage G Suite licenses for your domain"
}
}
}
},
"basePath": "/apps/licensing/v1/product/",
"baseUrl": "https://www.googleapis.com/apps/licensing/v1/product/",
"batchPath": "batch/licensing/v1",
"description": "Licensing API to view and manage licenses for your domain",
"discoveryVersion": "v1",
"documentationLink": "https://developers.google.com/admin-sdk/licensing/",
"etag": "\"F5McR9eEaw0XRpaO3M9gbIugkbs/V3n4vxCP3J8VvoP6bHur312Efdk\"",
"icons": {
"x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png",
"x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png"
},
"id": "licensing:v1",
"kind": "discovery#restDescription",
"name": "licensing",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"alt": {
"default": "json",
"description": "Data format for the response.",
"enum": [
"json"
],
"enumDescriptions": [
"Responses with Content-Type of application/json"
],
"location": "query",
"type": "string"
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
"key": {
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"type": "string"
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
"quotaUser": {
"description": "An opaque string that represents a user for quota purposes. Must not exceed 40 characters.",
"location": "query",
"type": "string"
},
"userIp": {
"description": "Deprecated. Please use quotaUser instead.",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
"resources": {
"licenseAssignments": {
"methods": {
"delete": {
"description": "Revoke a license.",
"httpMethod": "DELETE",
"id": "licensing.licenseAssignments.delete",
"parameterOrder": [
"productId",
"skuId",
"userId"
],
"parameters": {
"productId": {
"description": "A product's unique identifier. For more information about products in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
},
"skuId": {
"description": "A product SKU's unique identifier. For more information about available SKUs in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
},
"userId": {
"description": "The user's current primary email address. If the user's email address changes, use the new email address in your API requests.\nSince a userId is subject to change, do not use a userId value as a key for persistent data. This key could break if the current user's email address changes.\nIf the userId is suspended, the license status changes.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{productId}/sku/{skuId}/user/{userId}",
"scopes": [
"https://www.googleapis.com/auth/apps.licensing"
]
},
"get": {
"description": "Get a specific user's license by product SKU.",
"httpMethod": "GET",
"id": "licensing.licenseAssignments.get",
"parameterOrder": [
"productId",
"skuId",
"userId"
],
"parameters": {
"productId": {
"description": "A product's unique identifier. For more information about products in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
},
"skuId": {
"description": "A product SKU's unique identifier. For more information about available SKUs in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
},
"userId": {
"description": "The user's current primary email address. If the user's email address changes, use the new email address in your API requests.\nSince a userId is subject to change, do not use a userId value as a key for persistent data. This key could break if the current user's email address changes.\nIf the userId is suspended, the license status changes.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{productId}/sku/{skuId}/user/{userId}",
"response": {
"$ref": "LicenseAssignment"
},
"scopes": [
"https://www.googleapis.com/auth/apps.licensing"
]
},
"insert": {
"description": "Assign a license.",
"httpMethod": "POST",
"id": "licensing.licenseAssignments.insert",
"parameterOrder": [
"productId",
"skuId"
],
"parameters": {
"productId": {
"description": "A product's unique identifier. For more information about products in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
},
"skuId": {
"description": "A product SKU's unique identifier. For more information about available SKUs in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{productId}/sku/{skuId}/user",
"request": {
"$ref": "LicenseAssignmentInsert"
},
"response": {
"$ref": "LicenseAssignment"
},
"scopes": [
"https://www.googleapis.com/auth/apps.licensing"
]
},
"listForProduct": {
"description": "List all users assigned licenses for a specific product SKU.",
"httpMethod": "GET",
"id": "licensing.licenseAssignments.listForProduct",
"parameterOrder": [
"productId",
"customerId"
],
"parameters": {
"customerId": {
"description": "Customer's customerId. A previous version of this API accepted the primary domain name as a value for this field.\nIf the customer is suspended, the server returns an error.",
"location": "query",
"required": true,
"type": "string"
},
"maxResults": {
"default": "100",
"description": "The maxResults query string determines how many entries are returned on each page of a large response. This is an optional parameter. The value must be a positive number.",
"format": "uint32",
"location": "query",
"maximum": "1000",
"minimum": "1",
"type": "integer"
},
"pageToken": {
"default": "",
"description": "Token to fetch the next page of data. The maxResults query string is related to the pageToken since maxResults determines how many entries are returned on each page. This is an optional query string. If not specified, the server returns the first page.",
"location": "query",
"type": "string"
},
"productId": {
"description": "A product's unique identifier. For more information about products in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{productId}/users",
"response": {
"$ref": "LicenseAssignmentList"
},
"scopes": [
"https://www.googleapis.com/auth/apps.licensing"
]
},
"listForProductAndSku": {
"description": "List all users assigned licenses for a specific product SKU.",
"httpMethod": "GET",
"id": "licensing.licenseAssignments.listForProductAndSku",
"parameterOrder": [
"productId",
"skuId",
"customerId"
],
"parameters": {
"customerId": {
"description": "Customer's customerId. A previous version of this API accepted the primary domain name as a value for this field.\nIf the customer is suspended, the server returns an error.",
"location": "query",
"required": true,
"type": "string"
},
"maxResults": {
"default": "100",
"description": "The maxResults query string determines how many entries are returned on each page of a large response. This is an optional parameter. The value must be a positive number.",
"format": "uint32",
"location": "query",
"maximum": "1000",
"minimum": "1",
"type": "integer"
},
"pageToken": {
"default": "",
"description": "Token to fetch the next page of data. The maxResults query string is related to the pageToken since maxResults determines how many entries are returned on each page. This is an optional query string. If not specified, the server returns the first page.",
"location": "query",
"type": "string"
},
"productId": {
"description": "A product's unique identifier. For more information about products in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
},
"skuId": {
"description": "A product SKU's unique identifier. For more information about available SKUs in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{productId}/sku/{skuId}/users",
"response": {
"$ref": "LicenseAssignmentList"
},
"scopes": [
"https://www.googleapis.com/auth/apps.licensing"
]
},
"patch": {
"description": "Reassign a user's product SKU with a different SKU in the same product. This method supports patch semantics.",
"httpMethod": "PATCH",
"id": "licensing.licenseAssignments.patch",
"parameterOrder": [
"productId",
"skuId",
"userId"
],
"parameters": {
"productId": {
"description": "A product's unique identifier. For more information about products in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
},
"skuId": {
"description": "A product SKU's unique identifier. For more information about available SKUs in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
},
"userId": {
"description": "The user's current primary email address. If the user's email address changes, use the new email address in your API requests.\nSince a userId is subject to change, do not use a userId value as a key for persistent data. This key could break if the current user's email address changes.\nIf the userId is suspended, the license status changes.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{productId}/sku/{skuId}/user/{userId}",
"request": {
"$ref": "LicenseAssignment"
},
"response": {
"$ref": "LicenseAssignment"
},
"scopes": [
"https://www.googleapis.com/auth/apps.licensing"
]
},
"update": {
"description": "Reassign a user's product SKU with a different SKU in the same product.",
"httpMethod": "PUT",
"id": "licensing.licenseAssignments.update",
"parameterOrder": [
"productId",
"skuId",
"userId"
],
"parameters": {
"productId": {
"description": "A product's unique identifier. For more information about products in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
},
"skuId": {
"description": "A product SKU's unique identifier. For more information about available SKUs in this version of the API, see Products and SKUs.",
"location": "path",
"required": true,
"type": "string"
},
"userId": {
"description": "The user's current primary email address. If the user's email address changes, use the new email address in your API requests.\nSince a userId is subject to change, do not use a userId value as a key for persistent data. This key could break if the current user's email address changes.\nIf the userId is suspended, the license status changes.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{productId}/sku/{skuId}/user/{userId}",
"request": {
"$ref": "LicenseAssignment"
},
"response": {
"$ref": "LicenseAssignment"
},
"scopes": [
"https://www.googleapis.com/auth/apps.licensing"
]
}
}
}
},
"revision": "20190916",
"rootUrl": "https://www.googleapis.com/",
"schemas": {
"LicenseAssignment": {
"description": "Representation of a license assignment.",
"id": "LicenseAssignment",
"properties": {
"etags": {
"description": "ETag of the resource.",
"type": "string"
},
"kind": {
"default": "licensing#licenseAssignment",
"description": "Identifies the resource as a LicenseAssignment.",
"type": "string"
},
"productId": {
"annotations": {
"required": [
"licensing.licenseAssignments.update"
]
},
"description": "A product's unique identifier. For more information about products in this version of the API, see Product and SKU IDs.",
"type": "string"
},
"productName": {
"description": "Display Name of the product.",
"type": "string"
},
"selfLink": {
"description": "Link to this page.",
"type": "string"
},
"skuId": {
"annotations": {
"required": [
"licensing.licenseAssignments.update"
]
},
"description": "A product SKU's unique identifier. For more information about available SKUs in this version of the API, see Products and SKUs.",
"type": "string"
},
"skuName": {
"description": "Display Name of the sku of the product.",
"type": "string"
},
"userId": {
"annotations": {
"required": [
"licensing.licenseAssignments.update"
]
},
"description": "The user's current primary email address. If the user's email address changes, use the new email address in your API requests. Since a userId is subject to change, do not use a userId value as a key for persistent data. This key could break if the current user's email address changes. If the userId is suspended, the license status changes.",
"type": "string"
}
},
"type": "object"
},
"LicenseAssignmentInsert": {
"description": "Representation of a license assignment.",
"id": "LicenseAssignmentInsert",
"properties": {
"userId": {
"annotations": {
"required": [
"licensing.licenseAssignments.insert"
]
},
"description": "Email id of the user",
"type": "string"
}
},
"type": "object"
},
"LicenseAssignmentList": {
"description": "LicesnseAssignment List for a given product/sku for a customer.",
"id": "LicenseAssignmentList",
"properties": {
"etag": {
"description": "ETag of the resource.",
"type": "string"
},
"items": {
"description": "The LicenseAssignments in this page of results.",
"items": {
"$ref": "LicenseAssignment"
},
"type": "array"
},
"kind": {
"default": "licensing#licenseAssignmentList",
"description": "Identifies the resource as a collection of LicenseAssignments.",
"type": "string"
},
"nextPageToken": {
"description": "The token that you must submit in a subsequent request to retrieve additional license results matching your query parameters. The maxResults query string is related to the nextPageToken since maxResults determines how many entries are returned on each next page.",
"type": "string"
}
},
"type": "object"
}
},
"servicePath": "apps/licensing/v1/product/",
"title": "Licensing API",
"version": "v1"
}