square.rb 3.3.0.20191217

data/lib/square/api/catalog_api.rb

@@ -0,0 +1,545 @@
+module Square
+  # CatalogApi
+  class CatalogApi < BaseApi
+    def initialize(config, http_call_back: nil)
+      super(config, http_call_back: http_call_back)
+    end
+
+    # Deletes a set of [CatalogItem](#type-catalogitem)s based on the
+    # provided list of target IDs and returns a set of successfully deleted IDs
+    # in
+    # the response. Deletion is a cascading event such that all children of the
+    # targeted object are also deleted. For example, deleting a CatalogItem will
+    # also delete all of its [CatalogItemVariation](#type-catalogitemvariation)
+    # children.
+    # `BatchDeleteCatalogObjects` succeeds even if only a portion of the
+    # targeted
+    # IDs can be deleted. The response will only include IDs that were
+    # actually deleted.
+    # @param [BatchDeleteCatalogObjectsRequest] body Required parameter: An
+    # object containing the fields to POST for the request.  See the
+    # corresponding object definition for field details.
+    # @return [BatchDeleteCatalogObjectsResponse Hash] response from the API call
+    def batch_delete_catalog_objects(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/batch-delete'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Returns a set of objects based on the provided ID.
+    # Each [CatalogItem](#type-catalogitem) returned in the set includes all of
+    # its
+    # child information including: all of its
+    # [CatalogItemVariation](#type-catalogitemvariation) objects, references to
+    # its [CatalogModifierList](#type-catalogmodifierlist) objects, and the ids
+    # of
+    # any [CatalogTax](#type-catalogtax) objects that apply to it.
+    # @param [BatchRetrieveCatalogObjectsRequest] body Required parameter: An
+    # object containing the fields to POST for the request.  See the
+    # corresponding object definition for field details.
+    # @return [BatchRetrieveCatalogObjectsResponse Hash] response from the API call
+    def batch_retrieve_catalog_objects(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/batch-retrieve'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Creates or updates up to 10,000 target objects based on the provided
+    # list of objects. The target objects are grouped into batches and each
+    # batch is
+    # inserted/updated in an all-or-nothing manner. If an object within a batch
+    # is
+    # malformed in some way, or violates a database constraint, the entire batch
+    # containing that item will be disregarded. However, other batches in the
+    # same
+    # request may still succeed. Each batch may contain up to 1,000 objects, and
+    # batches will be processed in order as long as the total object count for
+    # the
+    # request (items, variations, modifier lists, discounts, and taxes) is no
+    # more
+    # than 10,000.
+    # @param [BatchUpsertCatalogObjectsRequest] body Required parameter: An
+    # object containing the fields to POST for the request.  See the
+    # corresponding object definition for field details.
+    # @return [BatchUpsertCatalogObjectsResponse Hash] response from the API call
+    def batch_upsert_catalog_objects(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/batch-upsert'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Upload an image file to create a new [CatalogImage](#type-catalogimage)
+    # for an existing
+    # [CatalogObject](#type-catalogobject). Images can be uploaded and linked in
+    # this request or created independently
+    # (without an object assignment) and linked to a
+    # [CatalogObject](#type-catalogobject) at a later time.
+    # CreateCatalogImage accepts HTTP multipart/form-data requests with a JSON
+    # part and an image file part in
+    # JPEG, PJPEG, PNG, or GIF format. The maximum file size is 15MB. The
+    # following is an example of such an HTTP request:
+    # ```
+    # POST /v2/catalog/images
+    # Accept: application/json
+    # Content-Type: multipart/form-data;boundary="boundary"
+    # Square-Version: XXXX-XX-XX
+    # Authorization: Bearer {ACCESS_TOKEN}
+    # --boundary
+    # Content-Disposition: form-data; name="request"
+    # Content-Type: application/json
+    # {
+    # "idempotency_key":"528dea59-7bfb-43c1-bd48-4a6bba7dd61f86",
+    # "object_id": "ND6EA5AAJEO5WL3JNNIAQA32",
+    # "image":{
+    # "id":"#TEMP_ID",
+    # "type":"IMAGE",
+    # "image_data":{
+    # "caption":"A picture of a cup of coffee"
+    # }
+    # }
+    # }
+    # --boundary
+    # Content-Disposition: form-data; name="image"; filename="Coffee.jpg"
+    # Content-Type: image/jpeg
+    # {ACTUAL_IMAGE_BYTES}
+    # --boundary
+    # ```
+    # Additional information and an example cURL request can be found in the
+    # [Create a Catalog Image
+    # recipe](https://developer.squareup.com/docs/more-apis/catalog/cookbook/cre
+    # ate-catalog-images).
+    # @param [CreateCatalogImageRequest] request Optional parameter: Example:
+    # @param [File | UploadIO] image_file Optional parameter: Example:
+    # @return [CreateCatalogImageResponse Hash] response from the API call
+    def create_catalog_image(request: nil,
+                             image_file: nil)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/images'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
+      # Prepare form parameters.
+      _parameters = {
+        'request' => Faraday::UploadIO.new(
+          StringIO.new(request.to_json),
+          'application/json'
+        ),
+        'image_file' => Faraday::UploadIO.new(
+          image_file,
+          'image/jpeg'
+        )
+      }
+      _parameters = APIHelper.form_encode_parameters(_parameters)
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: _parameters
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Returns information about the Square Catalog API, such as batch size
+    # limits for `BatchUpsertCatalogObjects`.
+    # @return [CatalogInfoResponse Hash] response from the API call
+    def catalog_info
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/info'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.get(
+        _query_url,
+        headers: _headers
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Returns a list of [CatalogObject](#type-catalogobject)s that includes
+    # all objects of a set of desired types (for example, all
+    # [CatalogItem](#type-catalogitem)
+    # and [CatalogTax](#type-catalogtax) objects) in the catalog. The `types`
+    # parameter
+    # is specified as a comma-separated list of valid
+    # [CatalogObject](#type-catalogobject) types:
+    # `ITEM`, `ITEM_VARIATION`, `MODIFIER`, `MODIFIER_LIST`, `CATEGORY`,
+    # `DISCOUNT`, `TAX`, `IMAGE`.
+    # __Important:__ ListCatalog does not return deleted catalog items. To
+    # retrieve
+    # deleted catalog items, use SearchCatalogObjects and set
+    # `include_deleted_objects`
+    # to `true`.
+    # @param [String] cursor Optional parameter: The pagination cursor returned
+    # in the previous response. Leave unset for an initial request. See
+    # [Pagination](https://developer.squareup.com/docs/basics/api101/pagination)
+    # for more information.
+    # @param [String] types Optional parameter: An optional case-insensitive,
+    # comma-separated list of object types to retrieve, for example
+    # `ITEM,ITEM_VARIATION,CATEGORY,IMAGE`.  The legal values are taken from the
+    # CatalogObjectType enum: `ITEM`, `ITEM_VARIATION`, `CATEGORY`, `DISCOUNT`,
+    # `TAX`, `MODIFIER`, `MODIFIER_LIST`, or `IMAGE`.
+    # @return [ListCatalogResponse Hash] response from the API call
+    def list_catalog(cursor: nil,
+                     types: nil)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/list'
+      _query_builder = APIHelper.append_url_with_query_parameters(
+        _query_builder,
+        'cursor' => cursor,
+        'types' => types
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.get(
+        _query_url,
+        headers: _headers
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Creates or updates the target [CatalogObject](#type-catalogobject).
+    # @param [UpsertCatalogObjectRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [UpsertCatalogObjectResponse Hash] response from the API call
+    def upsert_catalog_object(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/object'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Deletes a single [CatalogObject](#type-catalogobject) based on the
+    # provided ID and returns the set of successfully deleted IDs in the
+    # response.
+    # Deletion is a cascading event such that all children of the targeted
+    # object
+    # are also deleted. For example, deleting a [CatalogItem](#type-catalogitem)
+    # will also delete all of its
+    # [CatalogItemVariation](#type-catalogitemvariation) children.
+    # @param [String] object_id Required parameter: The ID of the catalog object
+    # to be deleted. When an object is deleted, other objects in the graph that
+    # depend on that object will be deleted as well (for example, deleting a
+    # catalog item will delete its catalog item variations).
+    # @return [DeleteCatalogObjectResponse Hash] response from the API call
+    def delete_catalog_object(object_id:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/object/{object_id}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'object_id' => object_id
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.delete(
+        _query_url,
+        headers: _headers
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Returns a single [CatalogItem](#type-catalogitem) as a
+    # [CatalogObject](#type-catalogobject) based on the provided ID. The
+    # returned
+    # object includes all of the relevant [CatalogItem](#type-catalogitem)
+    # information including: [CatalogItemVariation](#type-catalogitemvariation)
+    # children, references to its
+    # [CatalogModifierList](#type-catalogmodifierlist) objects, and the ids of
+    # any [CatalogTax](#type-catalogtax) objects that apply to it.
+    # @param [String] object_id Required parameter: The object ID of any type of
+    # catalog objects to be retrieved.
+    # @param [Boolean] include_related_objects Optional parameter: If `true`,
+    # the response will include additional objects that are related to the
+    # requested object, as follows:  If the `object` field of the response
+    # contains a CatalogItem, its associated CatalogCategory, CatalogTax
+    # objects, CatalogImages and CatalogModifierLists will be returned in the
+    # `related_objects` field of the response. If the `object` field of the
+    # response contains a CatalogItemVariation, its parent CatalogItem will be
+    # returned in the `related_objects` field of the response.  Default value:
+    # `false`
+    # @return [RetrieveCatalogObjectResponse Hash] response from the API call
+    def retrieve_catalog_object(object_id:,
+                                include_related_objects: nil)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/object/{object_id}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'object_id' => object_id
+      )
+      _query_builder = APIHelper.append_url_with_query_parameters(
+        _query_builder,
+        'include_related_objects' => include_related_objects
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.get(
+        _query_url,
+        headers: _headers
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Queries the targeted catalog using a variety of query types:
+    # [CatalogQuerySortedAttribute](#type-catalogquerysortedattribute),
+    # [CatalogQueryExact](#type-catalogqueryexact),
+    # [CatalogQueryRange](#type-catalogqueryrange),
+    # [CatalogQueryText](#type-catalogquerytext),
+    # [CatalogQueryItemsForTax](#type-catalogqueryitemsfortax), and
+    # [CatalogQueryItemsForModifierList](#type-catalogqueryitemsformodifierlist)
+    # .
+    # --
+    # --
+    # Future end of the above comment:
+    # [CatalogQueryItemsForTax](#type-catalogqueryitemsfortax),
+    # [CatalogQueryItemsForModifierList](#type-catalogqueryitemsformodifierlist)
+    # ,
+    # [CatalogQueryItemsForItemOptions](#type-catalogqueryitemsforitemoptions),
+    # and
+    # [CatalogQueryItemVariationsForItemOptionValues](#type-catalogqueryitemvari
+    # ationsforitemoptionvalues).
+    # @param [SearchCatalogObjectsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [SearchCatalogObjectsResponse Hash] response from the API call
+    def search_catalog_objects(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/search'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Updates the [CatalogModifierList](#type-catalogmodifierlist) objects
+    # that apply to the targeted [CatalogItem](#type-catalogitem) without having
+    # to perform an upsert on the entire item.
+    # @param [UpdateItemModifierListsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [UpdateItemModifierListsResponse Hash] response from the API call
+    def update_item_modifier_lists(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/update-item-modifier-lists'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+
+    # Updates the [CatalogTax](#type-catalogtax) objects that apply to the
+    # targeted [CatalogItem](#type-catalogitem) without having to perform an
+    # upsert on the entire item.
+    # @param [UpdateItemTaxesRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [UpdateItemTaxesResponse Hash] response from the API call
+    def update_item_taxes(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/catalog/update-item-taxes'
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+  end
+end

data/lib/square/api/checkout_api.rb

@@ -0,0 +1,49 @@
+module Square
+  # CheckoutApi
+  class CheckoutApi < BaseApi
+    def initialize(config, http_call_back: nil)
+      super(config, http_call_back: http_call_back)
+    end
+
+    # Links a `checkoutId` to a `checkout_page_url` that customers will
+    # be directed to in order to provide their payment information using a
+    # payment processing workflow hosted on connect.squareup.com.
+    # @param [String] location_id Required parameter: The ID of the business
+    # location to associate the checkout with.
+    # @param [CreateCheckoutRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [CreateCheckoutResponse Hash] response from the API call
+    def create_checkout(location_id:,
+                        body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/locations/{location_id}/checkouts'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'location_id' => location_id
+      )
+      _query_url = APIHelper.clean_url _query_builder
+
+      # Prepare headers.
+      _headers = {
+        'accept' => 'application/json',
+        'content-type' => 'application/json; charset=utf-8'
+      }
+
+      # Prepare and execute HttpRequest.
+      _request = config.http_client.post(
+        _query_url,
+        headers: _headers,
+        parameters: body.to_json
+      )
+      OAuth2.apply(config, _request)
+      _response = execute_request(_request)
+
+      # Return appropriate response type.
+      decoded = APIHelper.json_deserialize(_response.raw_body)
+      _errors = APIHelper.map_response(decoded, ['errors'])
+      ApiResponse.new(_response, data: decoded, errors: _errors)
+    end
+  end
+end