Generated PR for Release: 20.0.0.20220512

Author: autobot

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,30 @@
+---
+name: Bug report
+about: Create a report to help us improve Square SDKs
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**To Reproduce**
+Steps to reproduce the bug:
+1. (step 1)
+2. (step 2)
+3. (step 3)
+4. ...
+
+**Screenshots**
+If applicable, add screenshots to help explain the bug.
+
+**Square SDK version**
+For example:  17.2.x
+
+**Additional context**
+Add any other context about the problem here.

CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing to Square SDKs
+
+Thank you for your willingness to help improve the Square SDKs. Your feedback and expertise ultimately benefits everyone who builds with Square.
+
+If you encounter a bug while using Square SDKs, please [let us know](#bug-reporting).  We'll investigate the issue and fix it as soon as possible.
+
+We also accept feedback in the form of a pull request (PR), and will follow up with you if we need more information.  However, any code changes required will be perfomed by Square engineering, and we'll close the PR.
+
+## Bug report
+
+To report a bug: 
+* Go to the **[Issues](../../issues)** page.
+* Click **New issue**.
+* Click **Get started**.
+
+## Other support
+
+For all other support, including new feature requests, see:
+
+* Square developer forums:  [https://developer.squareup.com/forums](https://developer.squareup.com/forums)
+* Square support center:  [https://squareup.com/help/us/en](https://squareup.com/help/us/en)

README.md

@@ -12,7 +12,7 @@ Use this library to integrate Square payments into your app and grow your busine
 
 Use of the Square Ruby SDK requires:
 
-* Ruby 2.7 through 3.1
+* Ruby 2.6 through 3.1
 
 ## Installation
 
@@ -82,6 +82,7 @@ rake
 
 ### Customers
 * [Customers]
+* [Customer Custom Attributes]
 * [Customer Groups]
 * [Customer Segments]
 
@@ -100,6 +101,7 @@ rake
 * [Locations]
 * [Devices]
 * [Cash Drawers]
+* [Vendors]
 
 ### Team
 * [Team]
@@ -135,13 +137,15 @@ rake
 [Terminal]: doc/api/terminal.md
 [Team]: doc/api/team.md
 [Cash Drawers]: doc/api/cash-drawers.md
+[Vendors]: doc/api/vendors.md
 [Customer Groups]: doc/api/customer-groups.md
 [Customer Segments]: doc/api/customer-segments.md
 [Bank Accounts]: doc/api/bank-accounts.md
 [Payments]: doc/api/payments.md
 [Checkout]: doc/api/checkout.md
 [Catalog]: doc/api/catalog.md
 [Customers]: doc/api/customers.md
+[Customer Custom Attributes]: doc/api/customer-custom-attributes.md
 [Employees]: doc/api/employees.md
 [Inventory]: doc/api/inventory.md
 [Labor]: doc/api/labor.md

doc/api/bank-accounts.md

@@ -40,11 +40,7 @@ def list_bank_accounts(cursor: nil,
 ## Example Usage
 
 ```ruby
-cursor = 'cursor6'
-limit = 172
-location_id = 'location_id4'
-
-result = bank_accounts_api.list_bank_accounts(cursor: cursor, limit: limit, location_id: location_id)
+result = bank_accounts_api.list_bank_accounts()
 
 if result.success?
   puts result.data

doc/api/bookings.md

@@ -55,14 +55,7 @@ def list_bookings(limit: nil,
 ## Example Usage
 
 ```ruby
-limit = 172
-cursor = 'cursor6'
-team_member_id = 'team_member_id0'
-location_id = 'location_id4'
-start_at_min = 'start_at_min8'
-start_at_max = 'start_at_max8'
-
-result = bookings_api.list_bookings(limit: limit, cursor: cursor, team_member_id: team_member_id, location_id: location_id, start_at_min: start_at_min, start_at_max: start_at_max)
+result = bookings_api.list_bookings()
 
 if result.success?
   puts result.data
@@ -79,6 +72,9 @@ Creates a booking.
 To call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.
 To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.
 
+For calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus*
+or *Appointments Premium*.
+
 ```ruby
 def create_booking(body:)
 ```
@@ -97,13 +93,7 @@ def create_booking(body:)
 
 ```ruby
 body = {}
-body[:idempotency_key] = 'idempotency_key2'
 body[:booking] = {}
-body[:booking][:id] = 'id8'
-body[:booking][:version] = 148
-body[:booking][:status] = 'ACCEPTED'
-body[:booking][:created_at] = 'created_at6'
-body[:booking][:updated_at] = 'updated_at4'
 
 result = bookings_api.create_booking(body: body)
 
@@ -143,27 +133,6 @@ body = {}
 body[:query] = {}
 body[:query][:filter] = {}
 body[:query][:filter][:start_at_range] = {}
-body[:query][:filter][:start_at_range][:start_at] = 'start_at8'
-body[:query][:filter][:start_at_range][:end_at] = 'end_at4'
-body[:query][:filter][:location_id] = 'location_id6'
-body[:query][:filter][:segment_filters] = []
-
-
-body[:query][:filter][:segment_filters][0] = {}
-body[:query][:filter][:segment_filters][0][:service_variation_id] = 'service_variation_id8'
-body[:query][:filter][:segment_filters][0][:team_member_id_filter] = {}
-body[:query][:filter][:segment_filters][0][:team_member_id_filter][:all] = ['all7']
-body[:query][:filter][:segment_filters][0][:team_member_id_filter][:any] = ['any0', 'any1']
-body[:query][:filter][:segment_filters][0][:team_member_id_filter][:none] = ['none5']
-
-body[:query][:filter][:segment_filters][1] = {}
-body[:query][:filter][:segment_filters][1][:service_variation_id] = 'service_variation_id7'
-body[:query][:filter][:segment_filters][1][:team_member_id_filter] = {}
-body[:query][:filter][:segment_filters][1][:team_member_id_filter][:all] = ['all6', 'all7', 'all8']
-body[:query][:filter][:segment_filters][1][:team_member_id_filter][:any] = ['any1', 'any2', 'any3']
-body[:query][:filter][:segment_filters][1][:team_member_id_filter][:none] = ['none6', 'none7']
-
-body[:query][:filter][:booking_id] = 'booking_id6'
 
 result = bookings_api.search_availability(body: body)
 
@@ -228,11 +197,8 @@ def list_team_member_booking_profiles(bookable_only: false,
 
 ```ruby
 bookable_only = false
-limit = 172
-cursor = 'cursor6'
-location_id = 'location_id4'
 
-result = bookings_api.list_team_member_booking_profiles(bookable_only: bookable_only, limit: limit, cursor: cursor, location_id: location_id)
+result = bookings_api.list_team_member_booking_profiles(bookable_only: bookable_only, )
 
 if result.success?
   puts result.data
@@ -318,6 +284,9 @@ Updates a booking.
 To call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.
 To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.
 
+For calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus*
+or *Appointments Premium*.
+
 ```ruby
 def update_booking(booking_id:,
                    body:)
@@ -339,13 +308,7 @@ def update_booking(booking_id:,
 ```ruby
 booking_id = 'booking_id4'
 body = {}
-body[:idempotency_key] = 'idempotency_key2'
 body[:booking] = {}
-body[:booking][:id] = 'id8'
-body[:booking][:version] = 148
-body[:booking][:status] = 'ACCEPTED'
-body[:booking][:created_at] = 'created_at6'
-body[:booking][:updated_at] = 'updated_at4'
 
 result = bookings_api.update_booking(booking_id: booking_id, body: body)
 
@@ -364,6 +327,9 @@ Cancels an existing booking.
 To call this endpoint with buyer-level permissions, set `APPOINTMENTS_WRITE` for the OAuth scope.
 To call this endpoint with seller-level permissions, set `APPOINTMENTS_ALL_WRITE` and `APPOINTMENTS_WRITE` for the OAuth scope.
 
+For calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to *Appointments Plus*
+or *Appointments Premium*.
+
 ```ruby
 def cancel_booking(booking_id:,
                    body:)
@@ -385,8 +351,6 @@ def cancel_booking(booking_id:,
 ```ruby
 booking_id = 'booking_id4'
 body = {}
-body[:idempotency_key] = 'idempotency_key2'
-body[:booking_version] = 8
 
 result = bookings_api.cancel_booking(booking_id: booking_id, body: body)
 

doc/api/cards.md

@@ -46,13 +46,9 @@ def list_cards(cursor: nil,
 ## Example Usage
 
 ```ruby
-cursor = 'cursor6'
-customer_id = 'customer_id8'
 include_disabled = false
-reference_id = 'reference_id2'
-sort_order = 'DESC'
 
-result = cards_api.list_cards(cursor: cursor, customer_id: customer_id, include_disabled: include_disabled, reference_id: reference_id, sort_order: sort_order)
+result = cards_api.list_cards(include_disabled: include_disabled, )
 
 if result.success?
   puts result.data
@@ -86,20 +82,12 @@ def create_card(body:)
 body = {}
 body[:idempotency_key] = '4935a656-a929-4792-b97c-8848be85c27c'
 body[:source_id] = 'cnon:uIbfJXhXETSP197M3GB'
-body[:verification_token] = 'verification_token0'
 body[:card] = {}
-body[:card][:id] = 'id0'
-body[:card][:card_brand] = 'INTERAC'
-body[:card][:last_4] = 'last_42'
-body[:card][:exp_month] = 236
-body[:card][:exp_year] = 60
 body[:card][:cardholder_name] = 'Amelia Earhart'
 body[:card][:billing_address] = {}
 body[:card][:billing_address][:address_line_1] = '500 Electric Ave'
 body[:card][:billing_address][:address_line_2] = 'Suite 600'
-body[:card][:billing_address][:address_line_3] = 'address_line_34'
 body[:card][:billing_address][:locality] = 'New York'
-body[:card][:billing_address][:sublocality] = 'sublocality8'
 body[:card][:billing_address][:administrative_district_level_1] = 'NY'
 body[:card][:billing_address][:postal_code] = '10003'
 body[:card][:billing_address][:country] = 'US'

doc/api/cash-drawers.md

@@ -48,13 +48,8 @@ def list_cash_drawer_shifts(location_id:,
 
 ```ruby
 location_id = 'location_id4'
-sort_order = 'DESC'
-begin_time = 'begin_time2'
-end_time = 'end_time2'
-limit = 172
-cursor = 'cursor6'
 
-result = cash_drawers_api.list_cash_drawer_shifts(location_id: location_id, sort_order: sort_order, begin_time: begin_time, end_time: end_time, limit: limit, cursor: cursor)
+result = cash_drawers_api.list_cash_drawer_shifts(location_id: location_id, )
 
 if result.success?
   puts result.data
@@ -130,10 +125,8 @@ def list_cash_drawer_shift_events(location_id:,
 ```ruby
 location_id = 'location_id4'
 shift_id = 'shift_id0'
-limit = 172
-cursor = 'cursor6'
 
-result = cash_drawers_api.list_cash_drawer_shift_events(location_id: location_id, shift_id: shift_id, limit: limit, cursor: cursor)
+result = cash_drawers_api.list_cash_drawer_shift_events(location_id: location_id, shift_id: shift_id, )
 
 if result.success?
   puts result.data