Merge pull request #122 from square/release/32.0.0.20230925

Generated PR for Release: 32.0.0.20230925

Author: dotspencer

doc/api/booking-custom-attributes.md

@@ -259,12 +259,12 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 body = {
   :values => {
     'key0': {
-      :booking_id => 'booking_id8',
-      :key => 'key4'
+      :booking_id => 'booking_id4',
+      :key => 'key0'
     },
     'key1': {
-      :booking_id => 'booking_id9',
-      :key => 'key5'
+      :booking_id => 'booking_id4',
+      :key => 'key0'
     }
   }
 }
@@ -310,11 +310,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 body = {
   :values => {
     'key0': {
-      :booking_id => 'booking_id8',
+      :booking_id => 'booking_id4',
       :custom_attribute => {}
     },
     'key1': {
-      :booking_id => 'booking_id9',
+      :booking_id => 'booking_id4',
       :custom_attribute => {}
     }
   }

doc/api/bookings.md

@@ -16,6 +16,7 @@ bookings_api = client.bookings
 * [Bulk Retrieve Bookings](../../doc/api/bookings.md#bulk-retrieve-bookings)
 * [Retrieve Business Booking Profile](../../doc/api/bookings.md#retrieve-business-booking-profile)
 * [List Team Member Booking Profiles](../../doc/api/bookings.md#list-team-member-booking-profiles)
+* [Bulk Retrieve Team Member Booking Profiles](../../doc/api/bookings.md#bulk-retrieve-team-member-booking-profiles)
 * [Retrieve Team Member Booking Profile](../../doc/api/bookings.md#retrieve-team-member-booking-profile)
 * [Retrieve Booking](../../doc/api/bookings.md#retrieve-booking)
 * [Update Booking](../../doc/api/bookings.md#update-booking)
@@ -269,6 +270,46 @@ end
 ```
 
 
+# Bulk Retrieve Team Member Booking Profiles
+
+Retrieves one or more team members' booking profiles.
+
+```ruby
+def bulk_retrieve_team_member_booking_profiles(body:)
+```
+
+## Parameters
+
+| Parameter | Type | Tags | Description |
+|  --- | --- | --- | --- |
+| `body` | [`Bulk Retrieve Team Member Booking Profiles Request Hash`](../../doc/models/bulk-retrieve-team-member-booking-profiles-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
+
+## Response Type
+
+This method returns a `\ApiResponse` instance. The `data` property in this instance returns the response data which is of type [`Bulk Retrieve Team Member Booking Profiles Response Hash`](../../doc/models/bulk-retrieve-team-member-booking-profiles-response.md).
+
+## Example Usage
+
+```ruby
+body = {
+  :team_member_ids => [
+    'team_member_ids3',
+    'team_member_ids4',
+    'team_member_ids5'
+  ]
+}
+
+
+result = bookings_api.bulk_retrieve_team_member_booking_profiles(body: body)
+
+if result.success?
+  puts result.data
+elsif result.error?
+  warn result.errors
+end
+```
+
+
 # Retrieve Team Member Booking Profile
 
 Retrieves a team member's booking profile.

doc/api/checkout.md

@@ -28,8 +28,6 @@ payment processing workflow hosted on connect.squareup.com.
 
 NOTE: The Checkout API has been updated with new features.
 For more information, see [Checkout API highlights](https://developer.squareup.com/docs/checkout-api#checkout-api-highlights).
-We recommend that you use the new [CreatePaymentLink](api-endpoint:Checkout-CreatePaymentLink) 
-endpoint in place of this previously released endpoint.
 
 ```ruby
 def create_checkout(location_id:,

doc/api/customer-custom-attributes.md

@@ -279,11 +279,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 body = {
   :values => {
     'key0': {
-      :customer_id => 'customer_id2',
+      :customer_id => 'customer_id8',
       :custom_attribute => {}
     },
     'key1': {
-      :customer_id => 'customer_id3',
+      :customer_id => 'customer_id8',
       :custom_attribute => {}
     }
   }

doc/api/customers.md

@@ -166,8 +166,8 @@ body = {
         :rule => 'INCLUDE'
       },
       :created_at => {
-        :start_at => '2018-01-01T00:00:00+00:00',
-        :end_at => '2018-02-01T00:00:00+00:00'
+        :start_at => '2018-01-01T00:00:00-00:00',
+        :end_at => '2018-02-01T00:00:00-00:00'
       },
       :email_address => {
         :fuzzy => 'example.com'

doc/api/devices.md

@@ -10,9 +10,49 @@ devices_api = client.devices
 
 ## Methods
 
+* [List Devices](../../doc/api/devices.md#list-devices)
 * [List Device Codes](../../doc/api/devices.md#list-device-codes)
 * [Create Device Code](../../doc/api/devices.md#create-device-code)
 * [Get Device Code](../../doc/api/devices.md#get-device-code)
+* [Get Device](../../doc/api/devices.md#get-device)
+
+
+# List Devices
+
+List devices associated with the merchant. Currently, only Terminal API
+devices are supported.
+
+```ruby
+def list_devices(cursor: nil,
+                 sort_order: nil,
+                 limit: nil,
+                 location_id: nil)
+```
+
+## Parameters
+
+| Parameter | Type | Tags | Description |
+|  --- | --- | --- | --- |
+| `cursor` | `String` | Query, Optional | A pagination cursor returned by a previous call to this endpoint.<br>Provide this cursor to retrieve the next set of results for the original query.<br>See [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information. |
+| `sort_order` | [`String (Sort Order)`](../../doc/models/sort-order.md) | Query, Optional | The order in which results are listed.<br><br>- `ASC` - Oldest to newest.<br>- `DESC` - Newest to oldest (default). |
+| `limit` | `Integer` | Query, Optional | The number of results to return in a single page. |
+| `location_id` | `String` | Query, Optional | If present, only returns devices at the target location. |
+
+## Response Type
+
+This method returns a `\ApiResponse` instance. The `data` property in this instance returns the response data which is of type [`List Devices Response Hash`](../../doc/models/list-devices-response.md).
+
+## Example Usage
+
+```ruby
+result = devices_api.list_devices
+
+if result.success?
+  puts result.data
+elsif result.error?
+  warn result.errors
+end
+```
 
 
 # List Device Codes
@@ -127,3 +167,37 @@ elsif result.error?
 end
 ```
 
+
+# Get Device
+
+Retrieves Device with the associated `device_id`.
+
+```ruby
+def get_device(device_id:)
+```
+
+## Parameters
+
+| Parameter | Type | Tags | Description |
+|  --- | --- | --- | --- |
+| `device_id` | `String` | Template, Required | The unique ID for the desired `Device`. |
+
+## Response Type
+
+This method returns a `\ApiResponse` instance. The `data` property in this instance returns the response data which is of type [`Get Device Response Hash`](../../doc/models/get-device-response.md).
+
+## Example Usage
+
+```ruby
+device_id = 'device_id6'
+
+
+result = devices_api.get_device(device_id: device_id)
+
+if result.success?
+  puts result.data
+elsif result.error?
+  warn result.errors
+end
+```
+

doc/api/inventory.md

@@ -188,8 +188,8 @@ body = {
   :states => [
     'IN_STOCK'
   ],
-  :updated_after => '2016-11-01T00:00:00Z',
-  :updated_before => '2016-12-01T00:00:00Z'
+  :updated_after => '2016-11-01T00:00:00.000Z',
+  :updated_before => '2016-12-01T00:00:00.000Z'
 }
 
 
@@ -234,7 +234,7 @@ body = {
   :location_ids => [
     '59TNP9SA8VGDA'
   ],
-  :updated_after => '2016-11-16T00:00:00Z'
+  :updated_after => '2016-11-16T00:00:00.000Z'
 }
 
 
@@ -344,8 +344,8 @@ body = {
   :states => [
     'IN_STOCK'
   ],
-  :updated_after => '2016-11-01T00:00:00Z',
-  :updated_before => '2016-12-01T00:00:00Z'
+  :updated_after => '2016-11-01T00:00:00.000Z',
+  :updated_before => '2016-12-01T00:00:00.000Z'
 }
 
 
@@ -397,7 +397,7 @@ body = {
   :location_ids => [
     '59TNP9SA8VGDA'
   ],
-  :updated_after => '2016-11-16T00:00:00Z'
+  :updated_after => '2016-11-16T00:00:00.000Z'
 }
 
 

doc/api/labor.md

@@ -351,9 +351,9 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :shift => {
-    :start_at => '2019-01-25T08:11:00+00:00',
+    :start_at => '2019-01-25T03:11:00-05:00',
     :location_id => 'PAA1RJZZKXBFG',
-    :end_at => '2019-01-25T18:11:00+00:00',
+    :end_at => '2019-01-25T13:11:00-05:00',
     :wage => {
       :title => 'Barista',
       :hourly_rate => {
@@ -363,12 +363,12 @@ body = {
     },
     :breaks => [
       {
-        :start_at => '2019-01-25T11:11:00+00:00',
+        :start_at => '2019-01-25T06:11:00-05:00',
         :break_type_id => 'REGS1EQR1TPZ5',
         :name => 'Tea Break',
         :expected_duration => 'PT5M',
         :is_paid => true,
-        :end_at => '2019-01-25T11:16:00+00:00'
+        :end_at => '2019-01-25T06:16:00-05:00'
       }
     ],
     :team_member_id => 'ormj0jJJZ5OZIzxrZYJI'
@@ -551,9 +551,9 @@ id = 'id0'
 
 body = {
   :shift => {
-    :start_at => '2019-01-25T08:11:00+00:00',
+    :start_at => '2019-01-25T03:11:00-05:00',
     :location_id => 'PAA1RJZZKXBFG',
-    :end_at => '2019-01-25T18:11:00+00:00',
+    :end_at => '2019-01-25T13:11:00-05:00',
     :wage => {
       :title => 'Bartender',
       :hourly_rate => {
@@ -563,13 +563,13 @@ body = {
     },
     :breaks => [
       {
-        :start_at => '2019-01-25T11:11:00+00:00',
+        :start_at => '2019-01-25T06:11:00-05:00',
         :break_type_id => 'REGS1EQR1TPZ5',
         :name => 'Tea Break',
         :expected_duration => 'PT5M',
         :is_paid => true,
         :id => 'X7GAQYVVRRG6P',
-        :end_at => '2019-01-25T11:16:00+00:00'
+        :end_at => '2019-01-25T06:16:00-05:00'
       }
     ],
     :version => 1,

doc/api/location-custom-attributes.md

@@ -257,9 +257,15 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'id1': {},
-    'id2': {},
-    'id3': {}
+    'id1': {
+      :key => 'bestseller'
+    },
+    'id2': {
+      :key => 'bestseller'
+    },
+    'id3': {
+      :key => 'phone-number'
+    }
   }
 }
 
@@ -307,11 +313,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 body = {
   :values => {
     'key0': {
-      :location_id => 'location_id8',
+      :location_id => 'location_id4',
       :custom_attribute => {}
     },
     'key1': {
-      :location_id => 'location_id9',
+      :location_id => 'location_id4',
       :custom_attribute => {}
     }
   }

doc/api/merchant-custom-attributes.md

@@ -257,8 +257,12 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 ```ruby
 body = {
   :values => {
-    'id1': {},
-    'id2': {}
+    'id1': {
+      :key => 'alternative_seller_name'
+    },
+    'id2': {
+      :key => 'has_seen_tutorial'
+    }
   }
 }
 
@@ -306,11 +310,11 @@ This method returns a `\ApiResponse` instance. The `data` property in this insta
 body = {
   :values => {
     'key0': {
-      :merchant_id => 'merchant_id4',
+      :merchant_id => 'merchant_id0',
       :custom_attribute => {}
     },
     'key1': {
-      :merchant_id => 'merchant_id5',
+      :merchant_id => 'merchant_id0',
       :custom_attribute => {}
     }
   }