square.rb 6.5.0.20201028 → 7.0.0.20201118

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e89b291628ca9e34dd317c1cabd319b96d3e7861de70eb8e9b1e006f521bd9e7
-  data.tar.gz: 316cd50188c224693b87df34043991a7cea712cfdc22814d08b90268924bd85b
+  metadata.gz: b369570f3d13e26bc325eb51c619e0beb0b102fcf2165e833772903161db7a9b
+  data.tar.gz: f085f244216551f94863464ec50c3ae2ca46520c2aad30082de005dd5a3a6153
 SHA512:
-  metadata.gz: 7d3b58b7592ba99f662b7e6601f9eee48535fa61a5009c159d05a21080e75b5af4f182ba7907e6350830400790fcd802531a62b5130da19392e95e6c8af9322f
-  data.tar.gz: abf4ab1de91013ea370e77fa7186a2f9436831b2611d6bc574d1c1401c6f2d99676c5984c37a5024f5bbd231799b4d4a599bdc43b00557a213f8191a7039cc65
+  metadata.gz: 50996f5d00d2a7f52950fdf63ff3089bd70f90e523fcf588796bc0e3d07d08d298eee2444dc155e5abb6ed15f893e3181c8dd42d4e81c03fd8feaff623ef27fe
+  data.tar.gz: d59a431601b9ff93f851dc8c10413e4b121e5ba77c0c5d4c7bddd0492e0a57c2fbeafadae38c546b4b5a50b664674d3c31193ed344f74966a4399aba0211ef58

data/README.md

@@ -56,6 +56,9 @@ gem 'square.rb'
 ### Loyalty
 * [Loyalty]
 
+### Bookings
+* [Bookings]
+
 ### Business
 * [Merchants]
 * [Locations]
@@ -286,33 +289,34 @@ You can also use the Square API to create applications or services that work wit
 [Square API]: https://squareup.com/developers
 [sign up for a developer account]: https://squareup.com/signup?v=developers
 [Client]: doc/client.md
-[Devices]: doc/apis/devices.md
-[Disputes]: doc/apis/disputes.md
-[Terminal]: doc/apis/terminal.md
-[Team]: doc/apis/team.md
-[Cash Drawers]: doc/apis/cash-drawers.md
-[Customer Groups]: doc/apis/customer-groups.md
-[Customer Segments]: doc/apis/customer-segments.md
-[Bank Accounts]: doc/apis/bank-accounts
-[Payments]: doc/apis/payments.md
-[Checkout]: doc/apis/checkout.md
-[Catalog]: doc/apis/catalog.md
-[Customers]: doc/apis/customers.md
-[Employees]: doc/apis/employees.md
-[Inventory]: doc/apis/inventory.md
-[Labor]: doc/apis/labor.md
-[Loyalty]: doc/apis/loyalty.md
-[Locations]: doc/apis/locations.md
-[Merchants]: doc/apis/merchants.md
-[Orders]: doc/apis/orders.md
-[Invoices]: doc/apis/invoices.md
-[Apple Pay]: doc/apis/apple-pay.md
-[Refunds]: doc/apis/refunds.md
-[Subscriptions]: doc/apis/subscriptions.md
-[Mobile Authorization]: doc/apis/mobile-authorization.md
-[O Auth]: doc/apis/o-auth.md
-[V1 Locations]: doc/apis/v1-locations.md
-[V1 Employees]: doc/apis/v1-employees.md
-[V1 Transactions]: doc/apis/v1-transactions.md
-[V1 Items]: doc/apis/v1-items.md
-[Transactions]: doc/apis/transactions.md
+[Devices]: doc/api/devices.md
+[Disputes]: doc/api/disputes.md
+[Terminal]: doc/api/terminal.md
+[Team]: doc/api/team.md
+[Cash Drawers]: doc/api/cash-drawers.md
+[Customer Groups]: doc/api/customer-groups.md
+[Customer Segments]: doc/api/customer-segments.md
+[Bank Accounts]: doc/api/bank-accounts
+[Payments]: doc/api/payments.md
+[Checkout]: doc/api/checkout.md
+[Catalog]: doc/api/catalog.md
+[Customers]: doc/api/customers.md
+[Employees]: doc/api/employees.md
+[Inventory]: doc/api/inventory.md
+[Labor]: doc/api/labor.md
+[Loyalty]: doc/api/loyalty.md
+[Bookings]: doc/api/bookings.md
+[Locations]: doc/api/locations.md
+[Merchants]: doc/api/merchants.md
+[Orders]: doc/api/orders.md
+[Invoices]: doc/api/invoices.md
+[Apple Pay]: doc/api/apple-pay.md
+[Refunds]: doc/api/refunds.md
+[Subscriptions]: doc/api/subscriptions.md
+[Mobile Authorization]: doc/api/mobile-authorization.md
+[O Auth]: doc/api/o-auth.md
+[V1 Locations]: doc/api/v1-locations.md
+[V1 Employees]: doc/api/v1-employees.md
+[V1 Transactions]: doc/api/v1-transactions.md
+[V1 Items]: doc/api/v1-items.md
+[Transactions]: doc/api/transactions.md

data/lib/square.rb

@@ -37,6 +37,7 @@ require_relative 'square/api/v1_transactions_api.rb'
 require_relative 'square/api/v1_items_api.rb'
 require_relative 'square/api/apple_pay_api.rb'
 require_relative 'square/api/bank_accounts_api.rb'
+require_relative 'square/api/bookings_api.rb'
 require_relative 'square/api/cash_drawers_api.rb'
 require_relative 'square/api/catalog_api.rb'
 require_relative 'square/api/customers_api.rb'

data/lib/square/api/apple_pay_api.rb

@@ -14,8 +14,8 @@ module Square
     # Web Apple Pay with Square for merchants using their platform.
     # To learn more about Apple Pay on Web see the Apple Pay section in the
     # [Square Payment Form
-    # Walkthrough](https://developer.squareup.com/docs/docs/payment-form/payment
-    # -form-walkthrough).
+    # Walkthrough](https://developer.squareup.com/docs/payment-form/payment-form
+    # -walkthrough).
     # @param [RegisterDomainRequest] body Required parameter: An object
     # containing the fields to POST for the request.  See the corresponding
     # object definition for field details.

data/lib/square/api/bank_accounts_api.rb

@@ -10,8 +10,8 @@ module Square
     # @param [String] cursor Optional parameter: The pagination cursor returned
     # by a previous call to this endpoint. Use it in the next `ListBankAccounts`
     # request to retrieve the next set  of results.  See the
-    # [Pagination](https://developer.squareup.com/docs/docs/working-with-apis/pa
-    # gination) guide for more information.
+    # [Pagination](https://developer.squareup.com/docs/working-with-apis/paginat
+    # ion) guide for more information.
     # @param [Integer] limit Optional parameter: Upper limit on the number of
     # bank accounts to return in the response.  Currently, 1000 is the largest
     # supported limit. You can specify a limit  of up to 1000 bank accounts.
@@ -60,8 +60,8 @@ module Square
     # @param [String] v1_bank_account_id Required parameter: Connect V1 ID of
     # the desired `BankAccount`. For more information, see  [Retrieve a bank
     # account by using an ID issued by V1 Bank Accounts
-    # API](https://developer.squareup.com/docs/docs/bank-accounts-api#retrieve-a
-    # -bank-account-by-using-an-id-issued-by-v1-bank-accounts-api).
+    # API](https://developer.squareup.com/docs/bank-accounts-api#retrieve-a-bank
+    # -account-by-using-an-id-issued-by-v1-bank-accounts-api).
     # @return [GetBankAccountByV1IdResponse Hash] response from the API call
     def get_bank_account_by_v1_id(v1_bank_account_id:)
       # Prepare query url.

data/lib/square/api/base_api.rb

@@ -8,7 +8,7 @@ module Square
       @http_call_back = http_call_back
 
       @global_headers = {
-        'user-agent' => 'Square-Ruby-SDK/6.5.0.20201028',
+        'user-agent' => 'Square-Ruby-SDK/7.0.0.20201118',
         'Square-Version' => config.square_version
       }
     end

data/lib/square/api/bookings_api.rb

@@ -0,0 +1,266 @@
+module Square
+  # BookingsApi
+  class BookingsApi < BaseApi
+    def initialize(config, http_call_back: nil)
+      super(config, http_call_back: http_call_back)
+    end
+
+    # Creates a booking.
+    # @param [CreateBookingRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [CreateBookingResponse Hash] response from the API call
+    def create_booking(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/bookings'
+      _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
+
+    # Searches for availabilities for booking.
+    # @param [SearchAvailabilityRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [SearchAvailabilityResponse Hash] response from the API call
+    def search_availability(body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/bookings/availability/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
+
+    # Retrieves a seller's booking profile.
+    # @return [RetrieveBusinessBookingProfileResponse Hash] response from the API call
+    def retrieve_business_booking_profile
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/bookings/business-booking-profile'
+      _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
+
+    # Lists booking profiles for team members.
+    # @param [Boolean] bookable_only Optional parameter: Indicates whether to
+    # include only bookable team members in the returned result (`true`) or not
+    # (`false`).
+    # @param [Integer] limit Optional parameter: The maximum number of results
+    # to return.
+    # @param [String] cursor Optional parameter: The cursor for paginating
+    # through the results.
+    # @param [String] location_id Optional parameter: Indicates whether to
+    # include only team members enabled at the given location in the returned
+    # result.
+    # @return [ListTeamMemberBookingProfilesResponse Hash] response from the API call
+    def list_team_member_booking_profiles(bookable_only: false,
+                                          limit: nil,
+                                          cursor: nil,
+                                          location_id: nil)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/bookings/team-member-booking-profiles'
+      _query_builder = APIHelper.append_url_with_query_parameters(
+        _query_builder,
+        'bookable_only' => bookable_only,
+        'limit' => limit,
+        'cursor' => cursor,
+        'location_id' => location_id
+      )
+      _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
+
+    # Retrieves a team member's booking profile.
+    # @param [String] team_member_id Required parameter: The ID of the team
+    # member to retrieve.
+    # @return [RetrieveTeamMemberBookingProfileResponse Hash] response from the API call
+    def retrieve_team_member_booking_profile(team_member_id:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/bookings/team-member-booking-profiles/{team_member_id}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'team_member_id' => { 'value' => team_member_id, 'encode' => true }
+      )
+      _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
+
+    # Retrieves a booking.
+    # @param [String] booking_id Required parameter: The ID of the
+    # [Booking](#type-booking) object representing the to-be-retrieved
+    # booking.
+    # @return [RetrieveBookingResponse Hash] response from the API call
+    def retrieve_booking(booking_id:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/bookings/{booking_id}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'booking_id' => { 'value' => booking_id, 'encode' => true }
+      )
+      _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
+
+    # Updates a booking.
+    # @param [String] booking_id Required parameter: The ID of the
+    # [Booking](#type-booking) object representing the to-be-updated booking.
+    # @param [UpdateBookingRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [UpdateBookingResponse Hash] response from the API call
+    def update_booking(booking_id:,
+                       body:)
+      # Prepare query url.
+      _query_builder = config.get_base_uri
+      _query_builder << '/v2/bookings/{booking_id}'
+      _query_builder = APIHelper.append_url_with_template_parameters(
+        _query_builder,
+        'booking_id' => { 'value' => booking_id, 'encode' => true }
+      )
+      _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.put(
+        _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/cash_drawers_api.rb

@@ -63,7 +63,8 @@ module Square
     end
 
     # Provides the summary details for a single cash drawer shift. See
-    # RetrieveCashDrawerShiftEvents for a list of cash drawer shift events.
+    # [ListCashDrawerShiftEvents](#endpoint-CashDrawers-ListCashDrawerShiftEvent
+    # s) for a list of cash drawer shift events.
     # @param [String] location_id Required parameter: The ID of the location to
     # retrieve cash drawer shifts from.
     # @param [String] shift_id Required parameter: The shift ID.

data/lib/square/api/catalog_api.rb

@@ -239,9 +239,9 @@ module Square
     # `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`.
+    # deleted catalog items, use
+    # [SearchCatalogObjects](#endpoint-Catalog-SearchCatalogObjects)
+    # and set the `include_deleted_objects` attribute value 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)

data/lib/square/api/customer_segments_api.rb

@@ -9,8 +9,8 @@ module Square
     # @param [String] cursor Optional parameter: A pagination cursor returned by
     # previous calls to __ListCustomerSegments__. Used to retrieve the next set
     # of query results.  See the [Pagination
-    # guide](https://developer.squareup.com/docs/docs/working-with-apis/paginati
-    # on) for more information.
+    # guide](https://developer.squareup.com/docs/working-with-apis/pagination)
+    # for more information.
     # @return [ListCustomerSegmentsResponse Hash] response from the API call
     def list_customer_segments(cursor: nil)
       # Prepare query url.

data/lib/square/api/inventory_api.rb

@@ -208,8 +208,8 @@ module Square
     # @param [String] cursor Optional parameter: A pagination cursor returned by
     # a previous call to this endpoint. Provide this to retrieve the next set of
     # results for the original query.  See the
-    # [Pagination](https://developer.squareup.com/docs/docs/working-with-apis/pa
-    # gination) guide for more information.
+    # [Pagination](https://developer.squareup.com/docs/working-with-apis/paginat
+    # ion) guide for more information.
     # @return [RetrieveInventoryCountResponse Hash] response from the API call
     def retrieve_inventory_count(catalog_object_id:,
                                  location_ids: nil,

data/lib/square/api/invoices_api.rb

@@ -13,8 +13,8 @@ module Square
     # @param [String] cursor Optional parameter: A pagination cursor returned by
     # a previous call to this endpoint.  Provide this cursor to retrieve the
     # next set of results for your original query.  For more information, see
-    # [Pagination](https://developer.squareup.com/docs/docs/working-with-apis/pa
-    # gination).
+    # [Pagination](https://developer.squareup.com/docs/working-with-apis/paginat
+    # ion).
     # @param [Integer] limit Optional parameter: The maximum number of invoices
     # to return (200 is the maximum `limit`).  If not provided, the server  uses
     # a default limit of 100 invoices.

data/lib/square/api/loyalty_api.rb

@@ -123,7 +123,7 @@ module Square
     # [CalculateLoyaltyPoints](#endpoint-Loyalty-CalculateLoyaltyPoints) to
     # compute the points. For more information,
     # see [Loyalty Program
-    # Overview](https://developer.squareup.com/docs/docs/loyalty/overview).
+    # Overview](https://developer.squareup.com/docs/loyalty/overview).
     # You then provide the points in a request to this endpoint.
     # @param [String] account_id Required parameter: The [loyalty
     # account](#type-LoyaltyAccount) ID to which to add the points.

data/lib/square/api/mobile_authorization_api.rb

@@ -16,8 +16,8 @@ module Square
     # ```
     # Replace `ACCESS_TOKEN` with a
     # [valid production authorization
-    # credential](https://developer.squareup.com/docs/docs/build-basics/access-t
-    # okens).
+    # credential](https://developer.squareup.com/docs/build-basics/access-tokens
+    # ).
     # @param [CreateMobileAuthorizationCodeRequest] body Required parameter: An
     # object containing the fields to POST for the request.  See the
     # corresponding object definition for field details.

data/lib/square/api/o_auth_api.rb

@@ -85,7 +85,7 @@ module Square
     # ```
     # Replace `APPLICATION_SECRET` with the application secret on the
     # Credentials
-    # page in the [application dashboard](https://connect.squareup.com/apps).
+    # page in the [Developer Dashboard](https://developer.squareup.com/apps).
     # @param [RevokeTokenRequest] body Required parameter: An object containing
     # the fields to POST for the request.  See the corresponding object
     # definition for field details.
@@ -126,9 +126,6 @@ module Square
     # The endpoint supports distinct methods of obtaining OAuth access tokens.
     # Applications specify a method by adding the `grant_type` parameter
     # in the request and also provide relevant information.
-    # For more information, see [OAuth access token
-    # management](https://developer.squareup.com/docs/authz/oauth/how-it-works#o
-    # auth-access-token-management).
     # __Note:__ Regardless of the method application specified,
     # the endpoint always returns two items; an OAuth access token and
     # a refresh token in the response.

data/lib/square/api/refunds_api.rb

@@ -7,35 +7,35 @@ module Square
 
     # Retrieves a list of refunds for the account making the request.
     # The maximum results per page is 100.
-    # @param [String] begin_time Optional parameter: Timestamp for the beginning
-    # of the requested reporting period, in RFC 3339 format.  Default: The
-    # current time minus one year.
-    # @param [String] end_time Optional parameter: Timestamp for the end of the
-    # requested reporting period, in RFC 3339 format.  Default: The current
+    # @param [String] begin_time Optional parameter: The timestamp for the
+    # beginning of the requested reporting period, in RFC 3339 format.  Default:
+    # The current time minus one year.
+    # @param [String] end_time Optional parameter: The timestamp for the end of
+    # the requested reporting period, in RFC 3339 format.  Default: The current
     # time.
     # @param [String] sort_order Optional parameter: The order in which results
-    # are listed. - `ASC` - oldest to newest - `DESC` - newest to oldest
+    # are listed: - `ASC` - Oldest to newest. - `DESC` - Newest to oldest
     # (default).
     # @param [String] cursor Optional parameter: A pagination cursor returned by
-    # a previous call to this endpoint. Provide this to retrieve the next set of
-    # results for the original query.  See
+    # a previous call to this endpoint. Provide this cursor to retrieve the next
+    # set of results for the original query.  For more information, see
     # [Pagination](https://developer.squareup.com/docs/basics/api101/pagination)
-    # for more information.
+    # .
     # @param [String] location_id Optional parameter: Limit results to the
     # location supplied. By default, results are returned for all locations
-    # associated with the merchant.
+    # associated with the seller.
     # @param [String] status Optional parameter: If provided, only refunds with
     # the given status are returned. For a list of refund status values, see
-    # [PaymentRefund](#type-paymentrefund).  Default: If omitted refunds are
-    # returned regardless of status.
+    # [PaymentRefund](#type-paymentrefund).  Default: If omitted, refunds are
+    # returned regardless of their status.
     # @param [String] source_type Optional parameter: If provided, only refunds
     # with the given source type are returned. - `CARD` - List refunds only for
-    # payments where card was specified as payment source.  Default: If omitted
-    # refunds are returned regardless of source type.
-    # @param [Integer] limit Optional parameter: Maximum number of results to be
-    # returned in a single page. It is possible to receive fewer results than
-    # the specified limit on a given page.  If the supplied value is greater
-    # than 100, at most 100 results will be returned.  Default: `100`
+    # payments where `CARD` was specified as the payment source.  Default: If
+    # omitted, refunds are returned regardless of the source type.
+    # @param [Integer] limit Optional parameter: The maximum number of results
+    # to be returned in a single page.  It is possible to receive fewer results
+    # than the specified limit on a given page.  If the supplied value is
+    # greater than 100, no more than 100 results are returned.  Default: 100
     # @return [ListPaymentRefundsResponse Hash] response from the API call
     def list_payment_refunds(begin_time: nil,
                              end_time: nil,
@@ -118,8 +118,8 @@ module Square
     end
 
     # Retrieves a specific refund using the `refund_id`.
-    # @param [String] refund_id Required parameter: Unique ID for the desired
-    # `PaymentRefund`.
+    # @param [String] refund_id Required parameter: The unique ID for the
+    # desired `PaymentRefund`.
     # @return [GetPaymentRefundResponse Hash] response from the API call
     def get_payment_refund(refund_id:)
       # Prepare query url.

data/lib/square/api/subscriptions_api.rb

@@ -60,8 +60,8 @@ module Square
     # customer by subscription creation date.
     # For more information, see
     # [Retrieve
-    # subscriptions](https://developer.squareup.com/docs/docs/subscriptions-api/
-    # overview#retrieve-subscriptions).
+    # subscriptions](https://developer.squareup.com/docs/subscriptions-api/overv
+    # iew#retrieve-subscriptions).
     # @param [SearchSubscriptionsRequest] body Required parameter: An object
     # containing the fields to POST for the request.  See the corresponding
     # object definition for field details.
@@ -217,8 +217,8 @@ module Square
     # @param [String] cursor Optional parameter: A pagination cursor returned by
     # a previous call to this endpoint. Provide this to retrieve the next set of
     # results for the original query.  For more information, see
-    # [Pagination](https://developer.squareup.com/docs/docs/working-with-apis/pa
-    # gination).
+    # [Pagination](https://developer.squareup.com/docs/working-with-apis/paginat
+    # ion).
     # @param [Integer] limit Optional parameter: The upper limit on the number
     # of subscription events to return  in the response.   Default: `200`
     # @return [ListSubscriptionEventsResponse Hash] response from the API call

data/lib/square/api/team_api.rb

@@ -11,8 +11,8 @@ module Square
     # - `given_name`
     # - `family_name`
     # Learn about [Troubleshooting the Teams
-    # API](https://developer.squareup.com/docs/docs/team/troubleshooting#createt
-    # eammember).
+    # API](https://developer.squareup.com/docs/team/troubleshooting#createteamme
+    # mber).
     # @param [CreateTeamMemberRequest] body Required parameter: An object
     # containing the fields to POST for the request.  See the corresponding
     # object definition for field details.
@@ -54,8 +54,8 @@ module Square
     # marked as failed, but the body of the response
     # will contain explicit error information for this particular create.
     # Learn about [Troubleshooting the Teams
-    # API](https://developer.squareup.com/docs/docs/team/troubleshooting#bulkcre
-    # ateteammembers).
+    # API](https://developer.squareup.com/docs/team/troubleshooting#bulkcreatete
+    # ammembers).
     # @param [BulkCreateTeamMembersRequest] body Required parameter: An object
     # containing the fields to POST for the request.  See the corresponding
     # object definition for field details.
@@ -97,8 +97,8 @@ module Square
     # marked as failed, but the body of the response
     # will contain explicit error information for this particular update.
     # Learn about [Troubleshooting the Teams
-    # API](https://developer.squareup.com/docs/docs/team/troubleshooting#bulkupd
-    # ateteammembers).
+    # API](https://developer.squareup.com/docs/team/troubleshooting#bulkupdatete
+    # ammembers).
     # @param [BulkUpdateTeamMembersRequest] body Required parameter: An object
     # containing the fields to POST for the request.  See the corresponding
     # object definition for field details.
@@ -171,8 +171,8 @@ module Square
 
     # Retrieve a `TeamMember` object for the given `TeamMember.id`.
     # Learn about [Troubleshooting the Teams
-    # API](https://developer.squareup.com/docs/docs/team/troubleshooting#retriev
-    # eteammember).
+    # API](https://developer.squareup.com/docs/team/troubleshooting#retrieveteam
+    # member).
     # @param [String] team_member_id Required parameter: The ID of the team
     # member to retrieve.
     # @return [RetrieveTeamMemberResponse Hash] response from the API call
@@ -210,8 +210,8 @@ module Square
     # Updates a single `TeamMember` object. The `TeamMember` will be returned on
     # successful updates.
     # Learn about [Troubleshooting the Teams
-    # API](https://developer.squareup.com/docs/docs/team/troubleshooting#updatet
-    # eammember).
+    # API](https://developer.squareup.com/docs/team/troubleshooting#updateteamme
+    # mber).
     # @param [String] team_member_id Required parameter: The ID of the team
     # member to update.
     # @param [UpdateTeamMemberRequest] body Required parameter: An object
@@ -255,8 +255,8 @@ module Square
     # Retrieve a `WageSetting` object for a team member specified
     # by `TeamMember.id`.
     # Learn about [Troubleshooting the Teams
-    # API](https://developer.squareup.com/docs/docs/team/troubleshooting#retriev
-    # ewagesetting).
+    # API](https://developer.squareup.com/docs/team/troubleshooting#retrievewage
+    # setting).
     # @param [String] team_member_id Required parameter: The ID of the team
     # member to retrieve wage setting for
     # @return [RetrieveWageSettingResponse Hash] response from the API call
@@ -297,8 +297,8 @@ module Square
     # it fully replaces the `WageSetting` object for the team member.
     # The `WageSetting` will be returned upon successful update.
     # Learn about [Troubleshooting the Teams
-    # API](https://developer.squareup.com/docs/docs/team/troubleshooting#updatew
-    # agesetting).
+    # API](https://developer.squareup.com/docs/team/troubleshooting#updatewagese
+    # tting).
     # @param [String] team_member_id Required parameter: The ID of the team
     # member to update the `WageSetting` object for.
     # @param [UpdateWageSettingRequest] body Required parameter: An object

data/lib/square/client.rb

@@ -4,7 +4,7 @@ module Square
     attr_reader :config
 
     def sdk_version
-      '6.5.0.20201028'
+      '7.0.0.20201118'
     end
 
     def square_version
@@ -59,6 +59,12 @@ module Square
       @bank_accounts ||= BankAccountsApi.new config
     end
 
+    # Access to bookings controller.
+    # @return [BookingsApi] Returns the controller instance.
+    def bookings
+      @bookings ||= BookingsApi.new config
+    end
+
     # Access to cash_drawers controller.
     # @return [CashDrawersApi] Returns the controller instance.
     def cash_drawers
@@ -193,7 +199,7 @@ module Square
 
     def initialize(timeout: 60, max_retries: 0, retry_interval: 1,
                    backoff_factor: 1, environment: 'production',
-                   square_version: '2020-10-28', access_token: 'TODO: Replace',
+                   square_version: '2020-11-18', access_token: 'TODO: Replace',
                    additional_headers: {}, config: nil)
       @config = if config.nil?
                   Configuration.new(timeout: timeout, max_retries: max_retries,

data/lib/square/configuration.rb

@@ -22,7 +22,7 @@ module Square
 
     def initialize(timeout: 60, max_retries: 0, retry_interval: 1,
                    backoff_factor: 1, environment: 'production',
-                   square_version: '2020-10-28', access_token: 'TODO: Replace',
+                   square_version: '2020-11-18', access_token: 'TODO: Replace',
                    additional_headers: {})
       # The value to use for connection timeout
       @timeout = timeout
@@ -43,7 +43,7 @@ module Square
       # Square Connect API versions
       @square_version = square_version
 
-      # OAuth 2.0 Access Token
+      # The OAuth 2.0 Access Token to use for API requests.
       @access_token = access_token
 
       # Additional headers to add to each API request

data/lib/square/http/faraday_client.rb

@@ -30,7 +30,10 @@ module Square
         http_request.query_url
       ) do |request|
         request.headers = http_request.headers
-        request.body = http_request.parameters
+        unless http_request.http_method == HttpMethodEnum::GET &&
+               http_request.parameters.empty?
+          request.body = http_request.parameters
+        end
       end
       convert_response(response, http_request)
     end
@@ -42,7 +45,10 @@ module Square
         http_request.query_url
       ) do |request|
         request.headers = http_request.headers
-        request.body = http_request.parameters
+        unless http_request.http_method == HttpMethodEnum::GET &&
+               http_request.parameters.empty?
+          request.body = http_request.parameters
+        end
       end
       convert_response(response, http_request)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: square.rb
 version: !ruby/object:Gem::Version
-  version: 6.5.0.20201028
+  version: 7.0.0.20201118
 platform: ruby
 authors:
 - Square Developer Platform
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-10-28 00:00:00.000000000 Z
+date: 2020-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logging
@@ -139,6 +139,7 @@ files:
 - lib/square/api/apple_pay_api.rb
 - lib/square/api/bank_accounts_api.rb
 - lib/square/api/base_api.rb
+- lib/square/api/bookings_api.rb
 - lib/square/api/cash_drawers_api.rb
 - lib/square/api/catalog_api.rb
 - lib/square/api/checkout_api.rb
@@ -202,7 +203,7 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
     - !ruby/object:Gem::Version
       version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement