Skip to content

Commit c6181af

Browse files
author
autobot
committed
Generated PR for Release: 30.0.0.20230816
1 parent 08831b2 commit c6181af

File tree

883 files changed

+3679
-3239
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

883 files changed

+3679
-3239
lines changed

README.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,7 @@ pytest
8282

8383
### Orders
8484
* [Orders]
85+
* [Order Custom Attributes]
8586

8687
### Subscriptions
8788
* [Subscriptions]
@@ -107,10 +108,13 @@ pytest
107108

108109
### Bookings
109110
* [Bookings]
111+
* [Booking Custom Attributes]
110112

111113
### Business
112114
* [Merchants]
115+
* [Merchant Custom Attributes]
113116
* [Locations]
117+
* [Location Custom Attributes]
114118
* [Devices]
115119
* [Cash Drawers]
116120

@@ -162,9 +166,13 @@ The following Square APIs are [deprecated](https://developer.squareup.com/docs/b
162166
[Labor]: doc/api/labor.md
163167
[Loyalty]: doc/api/loyalty.md
164168
[Bookings]: doc/api/bookings.md
169+
[Booking Custom Attributes]: doc/api/booking-custom-attributes.md
165170
[Locations]: doc/api/locations.md
171+
[Location Custom Attributes]: doc/api/location-custom-attributes.md
166172
[Merchants]: doc/api/merchants.md
173+
[Merchant Custom Attributes]: doc/api/merchant-custom-attributes.md
167174
[Orders]: doc/api/orders.md
175+
[Order Custom Attributes]: doc/api/order-custom-attributes.md
168176
[Invoices]: doc/api/invoices.md
169177
[Apple Pay]: doc/api/apple-pay.md
170178
[Refunds]: doc/api/refunds.md

doc/api/apple-pay.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ def register_domain(self,
3636

3737
## Response Type
3838

39-
[`Register Domain Response`](../../doc/models/register-domain-response.md)
39+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Register Domain Response`](../../doc/models/register-domain-response.md).
4040

4141
## Example Usage
4242

doc/api/bank-accounts.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -30,13 +30,13 @@ def list_bank_accounts(self,
3030

3131
| Parameter | Type | Tags | Description |
3232
| --- | --- | --- | --- |
33-
| `cursor` | `string` | Query, Optional | The pagination cursor returned by a previous call to this endpoint.<br>Use it in the next `ListBankAccounts` request to retrieve the next set<br>of results.<br><br>See the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information. |
33+
| `cursor` | `str` | Query, Optional | The pagination cursor returned by a previous call to this endpoint.<br>Use it in the next `ListBankAccounts` request to retrieve the next set<br>of results.<br><br>See the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information. |
3434
| `limit` | `int` | Query, Optional | Upper limit on the number of bank accounts to return in the response.<br>Currently, 1000 is the largest supported limit. You can specify a limit<br>of up to 1000 bank accounts. This is also the default limit. |
35-
| `location_id` | `string` | Query, Optional | Location ID. You can specify this optional filter<br>to retrieve only the linked bank accounts belonging to a specific location. |
35+
| `location_id` | `str` | Query, Optional | Location ID. You can specify this optional filter<br>to retrieve only the linked bank accounts belonging to a specific location. |
3636

3737
## Response Type
3838

39-
[`List Bank Accounts Response`](../../doc/models/list-bank-accounts-response.md)
39+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`List Bank Accounts Response`](../../doc/models/list-bank-accounts-response.md).
4040

4141
## Example Usage
4242

@@ -64,11 +64,11 @@ def get_bank_account_by_v1_id(self,
6464

6565
| Parameter | Type | Tags | Description |
6666
| --- | --- | --- | --- |
67-
| `v1_bank_account_id` | `string` | Template, Required | Connect V1 ID of the desired `BankAccount`. For more information, see<br>[Retrieve a bank account by using an ID issued by V1 Bank Accounts API](https://developer.squareup.com/docs/bank-accounts-api#retrieve-a-bank-account-by-using-an-id-issued-by-v1-bank-accounts-api). |
67+
| `v1_bank_account_id` | `str` | Template, Required | Connect V1 ID of the desired `BankAccount`. For more information, see<br>[Retrieve a bank account by using an ID issued by V1 Bank Accounts API](https://developer.squareup.com/docs/bank-accounts-api#retrieve-a-bank-account-by-using-an-id-issued-by-v1-bank-accounts-api). |
6868

6969
## Response Type
7070

71-
[`Get Bank Account by V1 Id Response`](../../doc/models/get-bank-account-by-v1-id-response.md)
71+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Get Bank Account by V1 Id Response`](../../doc/models/get-bank-account-by-v1-id-response.md).
7272

7373
## Example Usage
7474

@@ -99,11 +99,11 @@ def get_bank_account(self,
9999

100100
| Parameter | Type | Tags | Description |
101101
| --- | --- | --- | --- |
102-
| `bank_account_id` | `string` | Template, Required | Square-issued ID of the desired `BankAccount`. |
102+
| `bank_account_id` | `str` | Template, Required | Square-issued ID of the desired `BankAccount`. |
103103

104104
## Response Type
105105

106-
[`Get Bank Account Response`](../../doc/models/get-bank-account-response.md)
106+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Get Bank Account Response`](../../doc/models/get-bank-account-response.md).
107107

108108
## Example Usage
109109

doc/api/booking-custom-attributes.md

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -41,11 +41,11 @@ def list_booking_custom_attribute_definitions(self,
4141
| Parameter | Type | Tags | Description |
4242
| --- | --- | --- | --- |
4343
| `limit` | `int` | Query, Optional | The maximum number of results to return in a single paged response. This limit is advisory.<br>The response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.<br>The default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination). |
44-
| `cursor` | `string` | Query, Optional | The cursor returned in the paged response from the previous call to this endpoint.<br>Provide this cursor to retrieve the next page of results for your original request.<br>For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination). |
44+
| `cursor` | `str` | Query, Optional | The cursor returned in the paged response from the previous call to this endpoint.<br>Provide this cursor to retrieve the next page of results for your original request.<br>For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination). |
4545

4646
## Response Type
4747

48-
[`List Booking Custom Attribute Definitions Response`](../../doc/models/list-booking-custom-attribute-definitions-response.md)
48+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`List Booking Custom Attribute Definitions Response`](../../doc/models/list-booking-custom-attribute-definitions-response.md).
4949

5050
## Example Usage
5151

@@ -83,7 +83,7 @@ def create_booking_custom_attribute_definition(self,
8383

8484
## Response Type
8585

86-
[`Create Booking Custom Attribute Definition Response`](../../doc/models/create-booking-custom-attribute-definition-response.md)
86+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Create Booking Custom Attribute Definition Response`](../../doc/models/create-booking-custom-attribute-definition-response.md).
8787

8888
## Example Usage
8989

@@ -121,11 +121,11 @@ def delete_booking_custom_attribute_definition(self,
121121

122122
| Parameter | Type | Tags | Description |
123123
| --- | --- | --- | --- |
124-
| `key` | `string` | Template, Required | The key of the custom attribute definition to delete. |
124+
| `key` | `str` | Template, Required | The key of the custom attribute definition to delete. |
125125

126126
## Response Type
127127

128-
[`Delete Booking Custom Attribute Definition Response`](../../doc/models/delete-booking-custom-attribute-definition-response.md)
128+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Delete Booking Custom Attribute Definition Response`](../../doc/models/delete-booking-custom-attribute-definition-response.md).
129129

130130
## Example Usage
131131

@@ -159,12 +159,12 @@ def retrieve_booking_custom_attribute_definition(self,
159159

160160
| Parameter | Type | Tags | Description |
161161
| --- | --- | --- | --- |
162-
| `key` | `string` | Template, Required | The key of the custom attribute definition to retrieve. If the requesting application<br>is not the definition owner, you must use the qualified key. |
162+
| `key` | `str` | Template, Required | The key of the custom attribute definition to retrieve. If the requesting application<br>is not the definition owner, you must use the qualified key. |
163163
| `version` | `int` | Query, Optional | The current version of the custom attribute definition, which is used for strongly consistent<br>reads to guarantee that you receive the most up-to-date data. When included in the request,<br>Square returns the specified version or a higher version if one exists. If the specified version<br>is higher than the current version, Square returns a `BAD_REQUEST` error. |
164164

165165
## Response Type
166166

167-
[`Retrieve Booking Custom Attribute Definition Response`](../../doc/models/retrieve-booking-custom-attribute-definition-response.md)
167+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Retrieve Booking Custom Attribute Definition Response`](../../doc/models/retrieve-booking-custom-attribute-definition-response.md).
168168

169169
## Example Usage
170170

@@ -201,12 +201,12 @@ def update_booking_custom_attribute_definition(self,
201201

202202
| Parameter | Type | Tags | Description |
203203
| --- | --- | --- | --- |
204-
| `key` | `string` | Template, Required | The key of the custom attribute definition to update. |
204+
| `key` | `str` | Template, Required | The key of the custom attribute definition to update. |
205205
| `body` | [`Update Booking Custom Attribute Definition Request`](../../doc/models/update-booking-custom-attribute-definition-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
206206

207207
## Response Type
208208

209-
[`Update Booking Custom Attribute Definition Response`](../../doc/models/update-booking-custom-attribute-definition-response.md)
209+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Update Booking Custom Attribute Definition Response`](../../doc/models/update-booking-custom-attribute-definition-response.md).
210210

211211
## Example Usage
212212

@@ -253,18 +253,18 @@ def bulk_delete_booking_custom_attributes(self,
253253

254254
## Response Type
255255

256-
[`Bulk Delete Booking Custom Attributes Response`](../../doc/models/bulk-delete-booking-custom-attributes-response.md)
256+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Bulk Delete Booking Custom Attributes Response`](../../doc/models/bulk-delete-booking-custom-attributes-response.md).
257257

258258
## Example Usage
259259

260260
```python
261261
body = {
262262
'values': {
263-
"key0": {
263+
'key0': {
264264
'booking_id': 'booking_id8',
265265
'key': 'key4'
266266
},
267-
"key1": {
267+
'key1': {
268268
'booking_id': 'booking_id9',
269269
'key': 'key5'
270270
}
@@ -304,18 +304,18 @@ def bulk_upsert_booking_custom_attributes(self,
304304

305305
## Response Type
306306

307-
[`Bulk Upsert Booking Custom Attributes Response`](../../doc/models/bulk-upsert-booking-custom-attributes-response.md)
307+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Bulk Upsert Booking Custom Attributes Response`](../../doc/models/bulk-upsert-booking-custom-attributes-response.md).
308308

309309
## Example Usage
310310

311311
```python
312312
body = {
313313
'values': {
314-
"key0": {
314+
'key0': {
315315
'booking_id': 'booking_id8',
316316
'custom_attribute': {}
317317
},
318-
"key1": {
318+
'key1': {
319319
'booking_id': 'booking_id9',
320320
'custom_attribute': {}
321321
}
@@ -351,14 +351,14 @@ def list_booking_custom_attributes(self,
351351

352352
| Parameter | Type | Tags | Description |
353353
| --- | --- | --- | --- |
354-
| `booking_id` | `string` | Template, Required | The ID of the target [booking](entity:Booking). |
354+
| `booking_id` | `str` | Template, Required | The ID of the target [booking](entity:Booking). |
355355
| `limit` | `int` | Query, Optional | The maximum number of results to return in a single paged response. This limit is advisory.<br>The response might contain more or fewer results. The minimum value is 1 and the maximum value is 100.<br>The default value is 20. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination). |
356-
| `cursor` | `string` | Query, Optional | The cursor returned in the paged response from the previous call to this endpoint.<br>Provide this cursor to retrieve the next page of results for your original request. For more<br>information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination). |
356+
| `cursor` | `str` | Query, Optional | The cursor returned in the paged response from the previous call to this endpoint.<br>Provide this cursor to retrieve the next page of results for your original request. For more<br>information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination). |
357357
| `with_definitions` | `bool` | Query, Optional | Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of each<br>custom attribute. Set this parameter to `true` to get the name and description of each custom<br>attribute, information about the data type, or other definition details. The default value is `false`.<br>**Default**: `False` |
358358

359359
## Response Type
360360

361-
[`List Booking Custom Attributes Response`](../../doc/models/list-booking-custom-attributes-response.md)
361+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`List Booking Custom Attributes Response`](../../doc/models/list-booking-custom-attributes-response.md).
362362

363363
## Example Usage
364364

@@ -400,12 +400,12 @@ def delete_booking_custom_attribute(self,
400400

401401
| Parameter | Type | Tags | Description |
402402
| --- | --- | --- | --- |
403-
| `booking_id` | `string` | Template, Required | The ID of the target [booking](entity:Booking). |
404-
| `key` | `string` | Template, Required | The key of the custom attribute to delete. This key must match the `key` of a custom<br>attribute definition in the Square seller account. If the requesting application is not the<br>definition owner, you must use the qualified key. |
403+
| `booking_id` | `str` | Template, Required | The ID of the target [booking](entity:Booking). |
404+
| `key` | `str` | Template, Required | The key of the custom attribute to delete. This key must match the `key` of a custom<br>attribute definition in the Square seller account. If the requesting application is not the<br>definition owner, you must use the qualified key. |
405405

406406
## Response Type
407407

408-
[`Delete Booking Custom Attribute Response`](../../doc/models/delete-booking-custom-attribute-response.md)
408+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Delete Booking Custom Attribute Response`](../../doc/models/delete-booking-custom-attribute-response.md).
409409

410410
## Example Usage
411411

@@ -446,14 +446,14 @@ def retrieve_booking_custom_attribute(self,
446446

447447
| Parameter | Type | Tags | Description |
448448
| --- | --- | --- | --- |
449-
| `booking_id` | `string` | Template, Required | The ID of the target [booking](entity:Booking). |
450-
| `key` | `string` | Template, Required | The key of the custom attribute to retrieve. This key must match the `key` of a custom<br>attribute definition in the Square seller account. If the requesting application is not the<br>definition owner, you must use the qualified key. |
449+
| `booking_id` | `str` | Template, Required | The ID of the target [booking](entity:Booking). |
450+
| `key` | `str` | Template, Required | The key of the custom attribute to retrieve. This key must match the `key` of a custom<br>attribute definition in the Square seller account. If the requesting application is not the<br>definition owner, you must use the qualified key. |
451451
| `with_definition` | `bool` | Query, Optional | Indicates whether to return the [custom attribute definition](entity:CustomAttributeDefinition) in the `definition` field of<br>the custom attribute. Set this parameter to `true` to get the name and description of the custom<br>attribute, information about the data type, or other definition details. The default value is `false`.<br>**Default**: `False` |
452452
| `version` | `int` | Query, Optional | The current version of the custom attribute, which is used for strongly consistent reads to<br>guarantee that you receive the most up-to-date data. When included in the request, Square<br>returns the specified version or a higher version if one exists. If the specified version is<br>higher than the current version, Square returns a `BAD_REQUEST` error. |
453453

454454
## Response Type
455455

456-
[`Retrieve Booking Custom Attribute Response`](../../doc/models/retrieve-booking-custom-attribute-response.md)
456+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Retrieve Booking Custom Attribute Response`](../../doc/models/retrieve-booking-custom-attribute-response.md).
457457

458458
## Example Usage
459459

@@ -499,13 +499,13 @@ def upsert_booking_custom_attribute(self,
499499

500500
| Parameter | Type | Tags | Description |
501501
| --- | --- | --- | --- |
502-
| `booking_id` | `string` | Template, Required | The ID of the target [booking](entity:Booking). |
503-
| `key` | `string` | Template, Required | The key of the custom attribute to create or update. This key must match the `key` of a<br>custom attribute definition in the Square seller account. If the requesting application is not<br>the definition owner, you must use the qualified key. |
502+
| `booking_id` | `str` | Template, Required | The ID of the target [booking](entity:Booking). |
503+
| `key` | `str` | Template, Required | The key of the custom attribute to create or update. This key must match the `key` of a<br>custom attribute definition in the Square seller account. If the requesting application is not<br>the definition owner, you must use the qualified key. |
504504
| `body` | [`Upsert Booking Custom Attribute Request`](../../doc/models/upsert-booking-custom-attribute-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
505505

506506
## Response Type
507507

508-
[`Upsert Booking Custom Attribute Response`](../../doc/models/upsert-booking-custom-attribute-response.md)
508+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Upsert Booking Custom Attribute Response`](../../doc/models/upsert-booking-custom-attribute-response.md).
509509

510510
## Example Usage
511511

0 commit comments

Comments
 (0)