square.rb 30.0.0.20230720 → 31.0.0.20230816

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 148935067852283c97b96532924b8990240a8471eb1fb004af84547db7a46e6f
-  data.tar.gz: f831947407ebced9aacc23b3db7cfae06b658899b21212c2548ca00a2acce842
+  metadata.gz: a240a4a6d004debbbfa68cda7f06de20424c7095df8cdd3f9874dab556d6f869
+  data.tar.gz: 5387eaf02e834b69df1cd238a8ba68e3d7195966d8b40f831e9942f52066e39f
 SHA512:
-  metadata.gz: d7045748e5af0118787c3658002f2c43a6e4db0e044e2707b58ae2d6690abd16ce01ae360889552611c43967261c93b33fd2bcd610c305b349b687e0d8c77605
-  data.tar.gz: 65360d7cd4eebb01bddba58ad85124a51d4a60ea21c8095235ce58182a2c58f26db1353374c4b914f3f1e96fd72e774efd0c0ba19c40bc231095998e1303d544
+  metadata.gz: d0296c13c1fc83e7e54d56cc397929f3d50ed3d243505c6372e890e7fec6cb65b6aabafd62bf15f80602982196ab36103bc8e7b816c633665717e172e0a8bdda
+  data.tar.gz: 2dce736c93cff6399463e35427319a4fe82009019c1300eafc39b3588a0056bdbba7bc26489b31f18152e22ffe6e9c7aadf10640b46384d8d0812755e65ab431

data/README.md

@@ -77,6 +77,7 @@ rake
 
 ### Orders
 * [Orders]
+* [Order Custom Attributes]
 
 ### Subscriptions
 * [Subscriptions]
@@ -103,10 +104,13 @@ rake
 
 ### Bookings
 * [Bookings]
+* [Booking Custom Attributes]
 
 ### Business
 * [Merchants]
+* [Merchant Custom Attributes]
 * [Locations]
+* [Location Custom Attributes]
 * [Devices]
 * [Cash Drawers]
 * [Vendors]
@@ -162,9 +166,13 @@ The following Square APIs are [deprecated](https://developer.squareup.com/docs/b
 [Labor]: doc/api/labor.md
 [Loyalty]: doc/api/loyalty.md
 [Bookings]: doc/api/bookings.md
+[Booking Custom Attributes]: doc/api/booking-custom-attributes.md
 [Locations]: doc/api/locations.md
+[Location Custom Attributes]: doc/api/location-custom-attributes.md
 [Merchants]: doc/api/merchants.md
+[Merchant Custom Attributes]: doc/api/merchant-custom-attributes.md
 [Orders]: doc/api/orders.md
+[Order Custom Attributes]: doc/api/order-custom-attributes.md
 [Invoices]: doc/api/invoices.md
 [Apple Pay]: doc/api/apple-pay.md
 [Refunds]: doc/api/refunds.md

data/lib/square/api/base_api.rb

@@ -4,7 +4,7 @@ module Square
     attr_accessor :config, :http_call_back
 
     def self.user_agent
-      'Square-Ruby-SDK/30.0.0.20230720 ({api-version}) {engine}/{engine-version} ({os-info}) {detail}'
+      'Square-Ruby-SDK/31.0.0.20230816 ({api-version}) {engine}/{engine-version} ({os-info}) {detail}'
     end
 
     def self.user_agent_parameters

data/lib/square/api/bookings_api.rb

@@ -11,6 +11,9 @@ module Square
     # @param [String] cursor Optional parameter: The pagination cursor from the
     # preceding response to return the next page of the results. Do not set this
     # when retrieving the first page of the results.
+    # @param [String] customer_id Optional parameter: The
+    # [customer](entity:Customer) for whom to retrieve bookings. If this is not
+    # set, bookings for all customers are retrieved.
     # @param [String] team_member_id Optional parameter: The team member for
     # whom to retrieve bookings. If this is not set, bookings of all members are
     # retrieved.
@@ -26,6 +29,7 @@ module Square
     # @return [ListBookingsResponse Hash] response from the API call
     def list_bookings(limit: nil,
                       cursor: nil,
+                      customer_id: nil,
                       team_member_id: nil,
                       location_id: nil,
                       start_at_min: nil,
@@ -36,6 +40,7 @@ module Square
                                      'default')
                    .query_param(new_parameter(limit, key: 'limit'))
                    .query_param(new_parameter(cursor, key: 'cursor'))
+                   .query_param(new_parameter(customer_id, key: 'customer_id'))
                    .query_param(new_parameter(team_member_id, key: 'team_member_id'))
                    .query_param(new_parameter(location_id, key: 'location_id'))
                    .query_param(new_parameter(start_at_min, key: 'start_at_min'))
@@ -110,6 +115,32 @@ module Square
         .execute
     end
 
+    # Bulk-Retrieves a list of bookings by booking IDs.
+    # To call this endpoint with buyer-level permissions, set
+    # `APPOINTMENTS_READ` for the OAuth scope.
+    # To call this endpoint with seller-level permissions, set
+    # `APPOINTMENTS_ALL_READ` and `APPOINTMENTS_READ` for the OAuth scope.
+    # @param [BulkRetrieveBookingsRequest] body Required parameter: An object
+    # containing the fields to POST for the request.  See the corresponding
+    # object definition for field details.
+    # @return [BulkRetrieveBookingsResponse Hash] response from the API call
+    def bulk_retrieve_bookings(body:)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v2/bookings/bulk-retrieve',
+                                     'default')
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:json_deserialize))
+                   .is_api_response(true)
+                   .convertor(ApiResponse.method(:create)))
+        .execute
+    end
+
     # Retrieves a seller's booking profile.
     # @return [RetrieveBusinessBookingProfileResponse Hash] response from the API call
     def retrieve_business_booking_profile

data/lib/square/api/gift_cards_api.rb

@@ -13,7 +13,7 @@ module Square
     # cards of all states.
     # @param [Integer] limit Optional parameter: If a limit is provided, the
     # endpoint returns only the specified number of results per page. The
-    # maximum value is 50. The default value is 30. For more information, see
+    # maximum value is 200. The default value is 30. For more information, see
     # [Pagination](https://developer.squareup.com/docs/working-with-apis/paginat
     # ion).
     # @param [String] cursor Optional parameter: A pagination cursor returned by

data/lib/square/client.rb

@@ -4,7 +4,7 @@ module Square
     attr_reader :config, :auth_managers
 
     def sdk_version
-      '30.0.0.20230720'
+      '31.0.0.20230816'
     end
 
     def square_version
@@ -267,7 +267,7 @@ module Square
                    retry_methods: %i[get put], http_callback: nil,
                    environment: 'production',
                    custom_url: 'https://connect.squareup.com', access_token: '',
-                   square_version: '2023-07-20', user_agent_detail: '',
+                   square_version: '2023-08-16', user_agent_detail: '',
                    additional_headers: {}, config: nil)
       @config = if config.nil?
                   Configuration.new(connection: connection, adapter: adapter,

data/lib/square/configuration.rb

@@ -19,7 +19,7 @@ module Square
                    retry_methods: %i[get put], http_callback: nil,
                    environment: 'production',
                    custom_url: 'https://connect.squareup.com', access_token: '',
-                   square_version: '2023-07-20', user_agent_detail: '',
+                   square_version: '2023-08-16', user_agent_detail: '',
                    additional_headers: {})
 
       super connection: connection, adapter: adapter, timeout: timeout,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: square.rb
 version: !ruby/object:Gem::Version
-  version: 30.0.0.20230720
+  version: 31.0.0.20230816
 platform: ruby
 authors:
 - Square Developer Platform
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-19 00:00:00.000000000 Z
+date: 2023-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: apimatic_core_interfaces