products.clj

(ns happygapi.androidenterprise.products
  "Google Play EMM API: products.
  Manages the deployment of apps to Android for Work users.
  See: https://developers.google.com/android/work/play/emm-apiapi/reference/rest/v1/products"
  (:require [cheshire.core :as json]
            [clj-http.client :as http]
            [happy.util :as util]))

(defn approve$
  "https://developers.google.com/android/work/play/emm-apiapi/reference/rest/v1/products/approve
  
  Required parameters: enterpriseId, productId
  
  Optional parameters: none
  
  Body: 
  
  {:approvalUrlInfo {:approvalUrl string, :kind string},
   :approvedPermissions string}
  
  Approves the specified product and the relevant app permissions, if any. The maximum number of products that you can approve per enterprise customer is 1,000.
  
  To learn how to use managed Google Play to design and create a store layout to display approved products to your users, see Store Layout Design."
  {:scopes ["https://www.googleapis.com/auth/androidenterprise"]}
  [auth args body]
  {:pre [(util/has-keys? args #{:enterpriseId :productId})]}
  (util/get-response
   (http/post
    (util/get-url
     "https://www.googleapis.com/androidenterprise/v1/"
     "enterprises/{enterpriseId}/products/{productId}/approve"
     #{:enterpriseId :productId}
     args)
    (merge-with
     merge
     {:content-type :json,
      :body (json/generate-string body),
      :throw-exceptions false,
      :query-params args,
      :accept :json,
      :as :json}
     auth))))

(defn generateApprovalUrl$
  "https://developers.google.com/android/work/play/emm-apiapi/reference/rest/v1/products/generateApprovalUrl
  
  Required parameters: enterpriseId, productId
  
  Optional parameters: languageCode
  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."
  {:scopes ["https://www.googleapis.com/auth/androidenterprise"]}
  [auth args]
  {:pre [(util/has-keys? args #{:enterpriseId :productId})]}
  (util/get-response
   (http/post
    (util/get-url
     "https://www.googleapis.com/androidenterprise/v1/"
     "enterprises/{enterpriseId}/products/{productId}/generateApprovalUrl"
     #{:enterpriseId :productId}
     args)
    (merge-with
     merge
     {:throw-exceptions false,
      :query-params args,
      :accept :json,
      :as :json}
     auth))))

(defn get$
  "https://developers.google.com/android/work/play/emm-apiapi/reference/rest/v1/products/get
  
  Required parameters: enterpriseId, productId
  
  Optional parameters: language
  Retrieves details of a product for display to an enterprise admin."
  {:scopes ["https://www.googleapis.com/auth/androidenterprise"]}
  [auth args]
  {:pre [(util/has-keys? args #{:enterpriseId :productId})]}
  (util/get-response
   (http/get
    (util/get-url
     "https://www.googleapis.com/androidenterprise/v1/"
     "enterprises/{enterpriseId}/products/{productId}"
     #{:enterpriseId :productId}
     args)
    (merge-with
     merge
     {:throw-exceptions false,
      :query-params args,
      :accept :json,
      :as :json}
     auth))))

(defn getAppRestrictionsSchema$
  "https://developers.google.com/android/work/play/emm-apiapi/reference/rest/v1/products/getAppRestrictionsSchema
  
  Required parameters: enterpriseId, productId
  
  Optional parameters: language
  Retrieves the schema that defines the configurable properties for this product. All products have a schema, but this schema may be empty if no managed configurations have been defined. This schema can be used to populate a UI that allows an admin to configure the product. To apply a managed configuration based on the schema obtained using this API, see Managed Configurations through Play."
  {:scopes ["https://www.googleapis.com/auth/androidenterprise"]}
  [auth args]
  {:pre [(util/has-keys? args #{:enterpriseId :productId})]}
  (util/get-response
   (http/get
    (util/get-url
     "https://www.googleapis.com/androidenterprise/v1/"
     "enterprises/{enterpriseId}/products/{productId}/appRestrictionsSchema"
     #{:enterpriseId :productId}
     args)
    (merge-with
     merge
     {:throw-exceptions false,
      :query-params args,
      :accept :json,
      :as :json}
     auth))))

(defn getPermissions$
  "https://developers.google.com/android/work/play/emm-apiapi/reference/rest/v1/products/getPermissions
  
  Required parameters: enterpriseId, productId
  
  Optional parameters: none
  Retrieves the Android app permissions required by this app."
  {:scopes ["https://www.googleapis.com/auth/androidenterprise"]}
  [auth args]
  {:pre [(util/has-keys? args #{:enterpriseId :productId})]}
  (util/get-response
   (http/get
    (util/get-url
     "https://www.googleapis.com/androidenterprise/v1/"
     "enterprises/{enterpriseId}/products/{productId}/permissions"
     #{:enterpriseId :productId}
     args)
    (merge-with
     merge
     {:throw-exceptions false,
      :query-params args,
      :accept :json,
      :as :json}
     auth))))

(defn list$
  "https://developers.google.com/android/work/play/emm-apiapi/reference/rest/v1/products/list
  
  Required parameters: enterpriseId
  
  Optional parameters: approved, language, maxResults, query, token
  Finds approved products that match a query, or all approved products if there is no query."
  {:scopes ["https://www.googleapis.com/auth/androidenterprise"]}
  [auth args]
  {:pre [(util/has-keys? args #{:enterpriseId})]}
  (util/get-response
   (http/get
    (util/get-url
     "https://www.googleapis.com/androidenterprise/v1/"
     "enterprises/{enterpriseId}/products"
     #{:enterpriseId}
     args)
    (merge-with
     merge
     {:throw-exceptions false,
      :query-params args,
      :accept :json,
      :as :json}
     auth))))

(defn unapprove$
  "https://developers.google.com/android/work/play/emm-apiapi/reference/rest/v1/products/unapprove
  
  Required parameters: enterpriseId, productId
  
  Optional parameters: none
  Unapproves the specified product (and the relevant app permissions, if any)"
  {:scopes ["https://www.googleapis.com/auth/androidenterprise"]}
  [auth args]
  {:pre [(util/has-keys? args #{:enterpriseId :productId})]}
  (util/get-response
   (http/post
    (util/get-url
     "https://www.googleapis.com/androidenterprise/v1/"
     "enterprises/{enterpriseId}/products/{productId}/unapprove"
     #{:enterpriseId :productId}
     args)
    (merge-with
     merge
     {:throw-exceptions false,
      :query-params args,
      :accept :json,
      :as :json}
     auth))))